Get-AzRmStorageShare
取得或列出記憶體檔案共用。
語法
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-AzRmStorageShare 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 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Filter
共用名稱的篩選。 指定時，只會列出以篩選開頭的共享名稱。 篩選格式必須為：startswith（name， <prefix>）
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-GetShareUsage
指定此參數以取得以位元組為單位的共用使用量。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IncludeDeleted
包含已刪除的共享，根據預設，清單共用不會包含已刪除的共用
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IncludeSnapshot
包含共用快照集，根據預設，清單共用不會包含共用快照集。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
共用名稱
| 類型: | String |
| 別名: | N, ShareName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceGroupName
資源群組名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceId
輸入檔案共用資源標識碼。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SnapshotTime
Share SnapshotTime
| 類型: | Nullable<T>[DateTime] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-StorageAccount
記憶體帳戶物件
| 類型: | PSStorageAccount |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountName
儲存體帳戶名稱。
| 類型: | String |
| 別名: | AccountName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
