[Storage] Support filter when listing share with management plane cmdlet Get-AzRmStorageShare (#23704)

* Support filter when listing share with mgmt plane cmdlet

* Add example

Author: yifanz7

src/Storage/Storage.Management.Test/ScenarioTests/StorageFileTests.ps1

@@ -85,6 +85,15 @@ function Test-StorageFileShare
 		Assert-AreEqual $shareName  $shares[1].Name
 		Assert-AreEqual $shareName2  $shares[0].Name
 
+		$shares = Get-AzRmStorageShare -ResourceGroupName $rgname -StorageAccountName $stoname -Filter "startswith(name, share)" 
+		Assert-AreEqual 2 $shares.Count
+		Assert-AreEqual $shareName  $shares[1].Name
+		Assert-AreEqual $shareName2  $shares[0].Name
+
+		$shares = Get-AzRmStorageShare -ResourceGroupName $rgname -StorageAccountName $stoname -Filter "startswith(name, share2)" 
+		Assert-AreEqual 1 $shares.Count 
+		Assert-AreEqual $shareName2 $shares[0].Name
+
 		Remove-AzRmStorageShare -Force -ResourceGroupName $rgname -StorageAccountName $stoname -Name $shareName
 		$shares = Get-AzRmStorageShare -ResourceGroupName $rgname -StorageAccountName $stoname
 		Assert-AreEqual 1 $shares.Count

src/Storage/Storage.Management.Test/SessionRecords/Microsoft.Azure.Commands.Management.Storage.Test.ScenarioTests.StorageFileTests/TestStorageFileShare.json

@@ -18,6 +18,8 @@
         - Additional information about change #1
 -->
 ## Upcoming Release
+* Supprted filter when listing file shares with management plane cmdlet 
+    - `Get-AzRmStorageShare`
 
 ## Version 6.0.1
 * Updated error message when storage context is missing in a cmdlet input 

src/Storage/Storage.Management/ChangeLog.md

@@ -143,6 +143,14 @@ public class GetAzureStorageShareCommand : StorageFileBaseCmdlet
             ParameterSetName = AccountObjectParameterSet)]
         public SwitchParameter IncludeSnapshot { get; set; }
 
+        [Parameter(Mandatory = false,
+            HelpMessage = "The filter of share name. When specified, only share names starting with the filter will be listed. The filter must be in format: startswith(name, <prefix>)",
+            ParameterSetName = AccountNameParameterSet)]
+        [Parameter(Mandatory = false,
+            HelpMessage = "The filter of share name. When specified, only share names starting with the filter will be listed. The filter must be in format: startswith(name, <prefix>)",
+            ParameterSetName = AccountObjectParameterSet)]
+        public string Filter { get; set; }
+
         public override void ExecuteCmdlet()
         {
             base.ExecuteCmdlet();
@@ -198,7 +206,8 @@ public override void ExecuteCmdlet()
                 IPage<FileShareItem> shares = this.StorageClient.FileShares.List(
                            this.ResourceGroupName,
                            this.StorageAccountName,
-                           expand: listSharesExpand);
+                           expand: listSharesExpand,
+                           filter: this.Filter);
                 WriteShareList(shares);
                 while (shares.NextPageLink != null)
                 {

src/Storage/Storage.Management/File/GetAzureStorageShare.cs

@@ -21,7 +21,7 @@ Get-AzRmStorageShare [-ResourceGroupName] <String> [-StorageAccountName] <String
 ### AccountName
 ```
 Get-AzRmStorageShare [-ResourceGroupName] <String> [-StorageAccountName] <String> [-IncludeDeleted]
- [-IncludeSnapshot] [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
+ [-IncludeSnapshot] [-Filter <String>] [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
 ```
 
 ### AccountObjectSingle
@@ -32,7 +32,7 @@ Get-AzRmStorageShare -StorageAccount <PSStorageAccount> -Name <String> [-Snapsho
 
 ### AccountObject
 ```
-Get-AzRmStorageShare -StorageAccount <PSStorageAccount> [-IncludeDeleted] [-IncludeSnapshot]
+Get-AzRmStorageShare -StorageAccount <PSStorageAccount> [-IncludeDeleted] [-IncludeSnapshot] [-Filter <String>]
  [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
 ```
 
@@ -140,6 +140,21 @@ testshare1 5120                     TransactionOptimized
 
 This command gets a single file share snapshot with share name and snapshot time.
 
+### Example 7: List Storage file shares of a Storage account with a filter
+```powershell
+Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Filter "startswith(name, test)"
+```
+
+```output
+ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount
+
+Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime
+----       -------- ---------------- ----------           ------- ------- --------------- ------------
+testshare1 5120     SMB              TransactionOptimized
+testshare2 5120     SMB              TransactionOptimized
+```
+This command lists all Storage file shares with names that begin with "test".
+
 ## PARAMETERS
 
 ### -DefaultProfile
@@ -157,6 +172,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Filter
+The filter of share name. When specified, only share names starting with the filter will be listed. The filter must be in format: startswith(name, <prefix>)
+
+```yaml
+Type: System.String
+Parameter Sets: AccountName, AccountObject
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -GetShareUsage
 Specify this parameter to get the Share Usage in Bytes.
 
@@ -309,10 +339,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## INPUTS
 
-### System.String
-
 ### Microsoft.Azure.Commands.Management.Storage.Models.PSStorageAccount
 
+### System.String
+
 ## OUTPUTS
 
 ### Microsoft.Azure.Commands.Management.Storage.Models.PSShare