deprecate and warning instead of remove

Author: haitch

src/ResourceManager/OperationalInsights/Commands.OperationalInsights/DataSources/GetAzureOperationalInsightsDataSourceCommand.cs

@@ -57,6 +57,7 @@ public class GetAzureOperationalInsightsDataSourceCommand : OperationalInsightsB
         HelpMessage = "The data source name.")]
         [Parameter(ParameterSetName = ByWorkspaceObjectByKind)]
         [ValidateSet(
+            PSDataSourceKinds.AzureAuditLog,
             PSDataSourceKinds.AzureActivityLog,
             PSDataSourceKinds.CustomLog,
             PSDataSourceKinds.LinuxPerformanceObject,
@@ -99,6 +100,11 @@ public override void ExecuteCmdlet()
             }
 
             if (ParameterSetName == ByWorkspaceObjectByKind || ParameterSetName == ByWorkspaceNameByKind) {
+                if (Kind == PSDataSourceKinds.AzureAuditLog)
+                {
+                    WriteWarning(Properties.Resources.DeprecateAzureAuditLogDataSource);
+                    return;
+                }
                 WriteObject(OperationalInsightsClient.FilterPSDataSources(ResourceGroupName, WorkspaceName, Kind), true);
                 return;
             }

src/ResourceManager/OperationalInsights/Commands.OperationalInsights/Microsoft.Azure.Commands.OperationalInsights.dll-Help.xml

@@ -1910,7 +1910,7 @@
 <command:details><command:name>Get-AzureRmOperationalInsightsDataSource</command:name>
 <command:verb>Get</command:verb>
 <command:noun>AzureRmOperationalInsightsDataSource</command:noun>
-<maml:description><maml:para>Gets data sources.
+<maml:description><maml:para>Get datasources under Azure Log Analytics workspace.
 </maml:para>
 </maml:description>
 </command:details>

src/ResourceManager/OperationalInsights/Commands.OperationalInsights/Models/PSDataSource.cs

@@ -35,6 +35,7 @@ public override string ToString()
     }
 
     public class PSDataSourceKinds {
+        public const string AzureAuditLog = "AzureAuditLog";
         public const string AzureActivityLog = "AzureActivityLog";
         public const string IISLogs = "IISLogs";
         public const string WindowsEvent = "WindowsEvent";

src/ResourceManager/OperationalInsights/Commands.OperationalInsights/Properties/Resources.Designer.cs

@@ -158,6 +158,9 @@ Are you sure you want to continue?</value>
   <data name="DataSourceWindowsEventNoEventTypeSelected" xml:space="preserve">
     <value>Please at least select one type of event to collect by using -CollectErrors -CollectWarnings -CollectInformation</value>
   </data>
+  <data name="DeprecateAzureAuditLogDataSource" xml:space="preserve">
+    <value>AzureAuditLog datasource has been deprecated, all your existing AzureAuditLog datasource has been migrated to AzureActivityLog.</value>
+  </data>
   <data name="FormattedCloudExceptionMessageTemplate" xml:space="preserve">
     <value>HTTP Status Code: {0}
 Error Code: {1}

src/ResourceManager/OperationalInsights/Commands.OperationalInsights/Properties/Resources.resx

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-AzureRmOperationalInsightsDataSource
 
 ## SYNOPSIS
-Gets data sources.
+Get datasources under Azure Log Analytics workspace.
 
 ## SYNTAX