Merge pull request #5877 from cormacpayne/resources-warnings

Add deprecation warnings for Resources cmdlets

Author: cormacpayne

src/ResourceManager/Resources/Commands.ResourceManager/Cmdlets/Implementation/Resource/FindAzureResourceCmdlet.cs

@@ -204,6 +204,7 @@ protected override void OnEndProcessing()
         /// </summary>
         private void RunCmdlet()
         {
+        	WriteWarning("Find-AzureRmResource: This cmdlet will be deprecated in an upcoming breaking change release. The functionality of this cmdlet will be moved into Get-AzureRmResource.");
             this.DefaultApiVersion = string.IsNullOrWhiteSpace(this.ApiVersion) ? Constants.ResourcesApiVersion : this.ApiVersion;
 
             if (!this.TenantLevel)

src/ResourceManager/Resources/Commands.ResourceManager/Cmdlets/Implementation/ResourceGroups/FindAzureResourceGroupCmdlet.cs

@@ -49,6 +49,7 @@ protected override void OnEndProcessing()
         /// </summary>
         private void RunCmdlet()
         {
+        	WriteWarning("Find-AzureRmResourceGroup: This cmdlet will be deprecated in an upcoming breaking change release. The functionality of this cmdlet will be moved into Get-AzureRmResourceGroup.");
             PaginatedResponseHelper.ForEach(
                getFirstPage: () => this.GetResourceGroups(),
                getNextPage: nextLink => this.GetNextLink<JObject>(nextLink),

src/ResourceManager/Resources/documentation/upcoming-breaking-changes.md

@@ -29,6 +29,34 @@
 
 The following cmdlets were affected this release:
 
+**Find-AzureRmResource**
+- This cmdlet is being removed and the functionality will be moved into `Get-AzureRmResource`
+
+```powershell
+# Old
+Find-AzureRmResource -ResourceType "Microsoft.Web/sites" -ResourceGroupNameContains "ResourceGroup"
+Find-AzureRmResource -ResourceType "Microsoft.Web/sites" -ResourceNameContains "test"
+
+# New
+Get-AzureRmResource -ResourceType "Microsoft.Web/sites" -ResourceGroupName "*ResourceGroup*"
+Get-AzureRmResource -ResourceType "Microsoft.Web/sites" -Name "*test*"
+```
+
+**Find-AzureRmResourceGroup**
+- This cmdlet is being removed and the functionality will be moved into `Get-AzureRmResourceGroup`
+
+```powershell
+# Old
+Find-AzureRmResourceGroup
+Find-AzureRmResourceGroup -Tag @{ "testtag" = $null }
+Find-AzureRmResourceGroup -Tag @{ "testtag" = "testval" }
+
+# New
+Get-AzureRmResourceGroup
+Get-AzureRmResourceGroup -Tag @{ "testtag" = $null }
+Get-AzureRmResourceGroup -Tag @{ "testtag" = "testval" }
+```
+
 **Get-AzureRmRoleDefinition**
 - Parameter "AtScopeAndBelow" is being removed.