[Storage] Add warning messages for upcoming breaking changes (#24227)

* Add breaking change warning messages

* update warning messages

Author: yifanz7

src/Storage/Storage.Management/ChangeLog.md

@@ -20,6 +20,14 @@
 ## Upcoming Release
 * Fixed parser logic when downloading blob from managed disk account with Sas Uri and bearer token on Linux and MacOS
     - `Get-AzStorageBlobContent`
+* Added warning messages for upcoming breaking changes in Queue cmdlets for removing references to "Microsoft.Azure.Storage.Queue"
+    - `New-AzStorageQueue`
+    - `Get-AzStorageQueue`
+    - `New-AzStorageQueueSASToken`
+* Added warning messages for an upcoming breaking change when uploading a file using SAS token without read permission 
+    - `Set-AzStorageFileContent`
+* Added warning messages for an upcoming breaking change when upgrading a Storage account to StorageV2
+    - `Set-AzStorageAccount`
 
 ## Version 6.1.1
 * Removed some code branches referencing Microsoft.Azure.Storage.Blob

src/Storage/Storage.Management/StorageAccount/SetAzureStorageAccount.cs

@@ -219,6 +219,7 @@ public PSNetworkRuleSet NetworkRuleSet
             get; set;
         }
 
+        [CmdletParameterBreakingChangeWithVersion("UpgradeToStorageV2", "12.0.0", "7.0.0", ChangeDescription = "A prompt that needs users' confirmation will be added when upgrading a storage account from StorageV1 or BlobStorage to StorageV2. Suppress it with -Force.")]
         [Parameter(
             Mandatory = false,
             HelpMessage = "Upgrade Storage Account Kind to StorageV2.")]

src/Storage/Storage/File/Cmdlet/SetAzureStorageFileContent.cs

@@ -96,6 +96,7 @@ public class SetAzureStorageFileContent : StorageFileDataManagementCmdletBase, I
         [ValidateNotNullOrEmpty]
         public string Source { get; set; }
 
+        [CmdletParameterBreakingChangeWithVersion("Path", "12.0.0", "7.0.0", ChangeDescription = "When uploading using SAS token without Read permission, the destination path will be taken as a file path, instead of a directory path previously.")]
         [Parameter(
             Position = 2,
             HelpMessage = "Path to the cloud file which would be uploaded to.")]

src/Storage/Storage/Queue/Cmdlet/GetAzureStorageQueue.cs

@@ -19,15 +19,18 @@ namespace Microsoft.WindowsAzure.Commands.Storage.Queue
     using global::Azure.Storage.Queues;
     using global::Azure.Storage.Queues.Models;
     using Microsoft.WindowsAzure.Commands.Storage.Common;
+    using Microsoft.WindowsAzure.Commands.Common.CustomAttributes;
     using Microsoft.WindowsAzure.Commands.Storage.Model.Contract;
     using System;
     using System.Globalization;
     using System.Management.Automation;
     using System.Security.Permissions;
+    using Microsoft.Azure.Storage.Queue;
 
     /// <summary>
     /// list azure queues
     /// </summary>
+    [CmdletOutputBreakingChangeWithVersion(typeof(AzureStorageQueue), "11.0.0", "6.0.0", ChangeDescription = "The child property CloudQueue and EncodeMessage from deprecated v11 SDK will be removed. Use child property QueueClient instead of CloudQueue.")]
     [Cmdlet("Get", Azure.Commands.ResourceManager.Common.AzureRMConstants.AzurePrefix + "StorageQueue", DefaultParameterSetName = NameParameterSet),OutputType(typeof(AzureStorageQueue))]
     public class GetAzureStorageQueueCommand : StorageQueueBaseCmdlet
     {

src/Storage/Storage/Queue/Cmdlet/NewAzureStorageQueue.cs

@@ -17,12 +17,14 @@ namespace Microsoft.WindowsAzure.Commands.Storage.Queue
     using Commands.Common.Storage.ResourceModel;
     using global::Azure.Storage.Queues;
     using global::Azure.Storage.Queues.Models;
+    using Microsoft.WindowsAzure.Commands.Common.CustomAttributes;
     using Microsoft.WindowsAzure.Commands.Storage.Common;
     using Microsoft.WindowsAzure.Commands.Storage.Model.Contract;
     using System;
     using System.Management.Automation;
     using System.Security.Permissions;
 
+    [CmdletOutputBreakingChangeWithVersion(typeof(AzureStorageQueue), "11.0.0", "6.0.0", ChangeDescription = "The child property CloudQueue and EncodeMessage from deprecated v11 SDK will be removed. Use child property QueueClient instead of CloudQueue.")]
     [Cmdlet("New", Azure.Commands.ResourceManager.Common.AzureRMConstants.AzurePrefix + "StorageQueue"),OutputType(typeof(AzureStorageQueue))]
     public class NewAzureStorageQueueCommand : StorageQueueBaseCmdlet
     {

src/Storage/Storage/Queue/Cmdlet/NewAzureStorageQueueSasToken.cs

@@ -62,6 +62,7 @@ public string Policy
         [ValidateNotNullOrEmpty]
         public string Permission { get; set; }
 
+        [CmdletParameterBreakingChangeWithVersion("Protocol", "12.0.0", "7.0.0", ChangeDescription = "The type of parameter Protocol will be changed from SharedAccessProtocol to string.")]
         [Parameter(Mandatory = false, HelpMessage = "Protocol can be used in the request with this SAS token.")]
         [ValidateNotNull]
         public SharedAccessProtocol? Protocol { get; set; }