Get-AzRmStorageShare

模組:

Az.Storage

取得或列出檔案共用 儲存體。

Syntax

Get-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-Name <String>]
   [-SnapshotTime <DateTime>]
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-IncludeDeleted]
   [-IncludeSnapshot]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-SnapshotTime <DateTime>]
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   [-IncludeDeleted]
   [-IncludeSnapshot]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   [-ResourceId] <String>
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzRm 儲存體 Share Cmdlet 會取得或列出檔案共用 儲存體。

範例

範例 1：使用 儲存體 帳戶名稱和共享名稱取得 儲存體 檔案共用

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

此命令會取得具有 儲存體 帳戶名稱和共用名稱 儲存體 檔案共用。

範例 2：列出 儲存體 帳戶的所有 儲存體 檔案共用

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes
----     -------- ---------------- ----------           ------- ------- ---------------
share1   5120                     TransactionOptimized
share2   5120                     TransactionOptimized

此命令會列出具有 儲存體 帳戶名稱之 儲存體 帳戶的所有 儲存體 檔案共用。

範例 3：使用 儲存體 帳戶物件和容器名稱取得 儲存體 Blob 容器。

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Get-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

此命令會取得具有 儲存體 帳戶物件和容器名稱 儲存體 Blob 容器。

範例 4：以位元組為單位取得 儲存體 檔案共用

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -GetShareUsage

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120                                                2097152

此命令會取得具有 儲存體 帳戶名稱和共用名稱的 儲存體 檔案共用，並以位元組為單位包含共用使用量。

範例 5：列出 儲存體 帳戶的所有 儲存體 檔案共用、包含已刪除的共用、包含共用快照集

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -IncludeDeleted -IncludeSnapshot

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version          ShareUsageBytes snapshotTime       
----       -------- ---------------- ----------           ------- -------          --------------- ------------       
testshare1 5120                     TransactionOptimized                                          2021-05-10T08:04:08Z
testshare1 5120                     TransactionOptimized                                                      
share1     100                      TransactionOptimized True    01D61FD1FC5498B6

此命令會列出所有 儲存體 檔案共用，包括已刪除的共用和共用快照集。

範例 6：取得單一共用快照集

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "testshare1" -SnapshotTime "2021-05-10T08:04:08Z"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime       
----       -------- ---------------- ----------           ------- ------- --------------- ------------       
testshare1 5120                     TransactionOptimized                                 2021-05-10T08:04:08Z

此命令會取得具有共享名稱和快照集時間的單一檔案共用快照集。

範例 7：使用篩選列出 儲存體 帳戶 儲存體 檔案共用

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Filter "startswith(name, test)"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime
----       -------- ---------------- ----------           ------- ------- --------------- ------------
testshare1 5120     SMB              TransactionOptimized
testshare2 5120     SMB              TransactionOptimized

此命令會列出名稱開頭為 「test」 的所有 儲存體 檔案共用。

參數

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

共用名稱的篩選。 指定時，只會列出以篩選開頭的共享名稱。 篩選格式必須為：startswith（name， <prefix>）

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GetShareUsage

指定此參數以取得以位元組為單位的共用使用量。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeDeleted

包含已刪除的共享，根據預設，清單共用不會包含已刪除的共用

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeSnapshot

包含共用快照集，根據預設，清單共用不會包含共用快照集。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

共用名稱

Type:	String
Aliases:	N, ShareName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

資源群組名稱。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

輸入檔案共用資源標識碼。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SnapshotTime

Share SnapshotTime

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccount

儲存體 帳戶物件

Type:	PSStorageAccount
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountName

儲存體 帳戶名稱。

Type:	String
Aliases:	AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

PSStorageAccount

String

輸出

PSShare