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,7 +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 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
     {
@@ -11,7 +15,7 @@ public class AddUrlAcl : PSCmdlet
 
         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.");
+            WriteWarning("ServiceControl no longer requires URL reservations, so this command no longer functions. Use 'netsh http add urlacl' instead.");
         }
 
         [ValidateNotNullOrEmpty]

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

@@ -1,13 +1,17 @@
 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.");
+            WriteWarning("ServiceControl no longer requires URL reservations, so this command no longer functions. Use 'netsh http show urlacl' instead.");
         }
     }
 }

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

@@ -1,13 +1,17 @@
 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.");
+            WriteWarning("ServiceControl no longer requires URL reservations, so this command no longer functions. Use 'netsh http delete urlacl' instead.");
         }
     }
 }

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)" />