Add obsolete warnings to PowerShell commands

Author: bording

src/Directory.Packages.props

@@ -60,6 +60,7 @@
     <PackageVersion Include="Particular.Approvals" Version="2.0.1" />
     <PackageVersion Include="Particular.Licensing.Sources" Version="6.1.0" />
     <PackageVersion Include="Particular.LicensingComponent.Report" Version="1.0.0" />
+    <PackageVersion Include="Particular.Obsoletes" Version="1.0.0" />
     <PackageVersion Include="Polly.Core" Version="8.5.2" />
     <PackageVersion Include="PropertyChanged.Fody" Version="4.1.0" />
     <PackageVersion Include="PropertyChanging.Fody" Version="1.30.3" />

src/ServiceControl.Management.PowerShell/Cmdlets/UrlAcls/AddUrlAcl.cs

@@ -1,19 +1,18 @@
 namespace ServiceControl.Management.PowerShell
 {
+    using System;
     using System.Management.Automation;
+    using Particular.Obsoletes;
 
+    [ObsoleteMetadata(Message = "ServiceControl no longer requires URL reservations, so this command no longer functions", ReplacementTypeOrMember = "netsh http add urlacl", TreatAsErrorFromVersion = "7", RemoveInVersion = "8")]
+    [Obsolete("ServiceControl no longer requires URL reservations, so this command no longer functions. Use 'netsh http add urlacl' instead. Will be treated as an error from version 7.0.0. Will be removed in version 8.0.0.", false)]
     [Cmdlet(VerbsCommon.Add, "UrlAcl")]
     public class AddUrlAcl : PSCmdlet
     {
         [ValidateNotNullOrEmpty]
         [Parameter(Mandatory = true, Position = 0, HelpMessage = "The URL to add to the URLACL list. This should always in a trailing /")]
         public string Url { get; set; }
 
-        protected override void ProcessRecord()
-        {
-            WriteWarning("ServiceControl no longer requires URL reservations, so this command no longer functions. Use the 'netsh http add urlacl' command instead.");
-        }
-
         [ValidateNotNullOrEmpty]
         [Parameter(Mandatory = true, Position = 1, HelpMessage = "The user or group to assign to this URLACL")]
         public string[] Users;

src/ServiceControl.Management.PowerShell/Cmdlets/UrlAcls/GetUrlAcls.cs

@@ -1,13 +1,11 @@
 namespace ServiceControl.Management.PowerShell
 {
+    using System;
     using System.Management.Automation;
+    using Particular.Obsoletes;
 
+    [ObsoleteMetadata(Message = "ServiceControl no longer requires URL reservations, so this command no longer functions", ReplacementTypeOrMember = "netsh http show urlacl", TreatAsErrorFromVersion = "7", RemoveInVersion = "8")]
+    [Obsolete("ServiceControl no longer requires URL reservations, so this command no longer functions. Use 'netsh http show urlacl' instead. Will be treated as an error from version 7.0.0. Will be removed in version 8.0.0.", false)]
     [Cmdlet(VerbsCommon.Get, "UrlAcls")]
-    public class GetUrlAcls : PSCmdlet
-    {
-        protected override void ProcessRecord()
-        {
-            WriteWarning("ServiceControl no longer requires URL reservations, so this command no longer functions. Use the 'netsh http show urlacl' command instead.");
-        }
-    }
+    public class GetUrlAcls : PSCmdlet;
 }

src/ServiceControl.Management.PowerShell/Cmdlets/UrlAcls/RemoveUrlAcl.cs

@@ -1,13 +1,11 @@
 namespace ServiceControl.Management.PowerShell
 {
+    using System;
     using System.Management.Automation;
+    using Particular.Obsoletes;
 
+    [ObsoleteMetadata(Message = "ServiceControl no longer requires URL reservations, so this command no longer functions", ReplacementTypeOrMember = "netsh http delete urlacl", TreatAsErrorFromVersion = "7", RemoveInVersion = "8")]
+    [Obsolete("ServiceControl no longer requires URL reservations, so this command no longer functions. Use 'netsh http delete urlacl' instead. Will be treated as an error from version 7.0.0. Will be removed in version 8.0.0.", false)]
     [Cmdlet(VerbsCommon.Remove, "UrlAcl")]
-    public class RemoveUrlAcl : PSCmdlet
-    {
-        protected override void ProcessRecord()
-        {
-            WriteWarning("ServiceControl no longer requires URL reservations, so this command no longer functions. Use the 'netsh http delete urlacl' command instead.");
-        }
-    }
+    public class RemoveUrlAcl : PSCmdlet;
 }

src/ServiceControl.Management.PowerShell/ServiceControl.Management.PowerShell.csproj

@@ -30,6 +30,10 @@
     <PackageReference Include="System.Management.Automation" />
   </ItemGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Particular.Obsoletes" PrivateAssets="All" ExcludeAssets="runtime" />
+  </ItemGroup>
+
   <ItemGroup>
     <Artifact Include="$(OutputPath)" DestinationFolder="$(PowerShellModuleArtifactsPath)" />
     <Artifact Include="$(PkgMicrosoft_Extensions_DependencyModel)\lib\netstandard2.0\Microsoft.Extensions.DependencyModel.dll" DestinationFolder="$(PowerShellModuleArtifactsPath)" />