Get-AzStorageContainer
語法
ContainerName (預設值)
Get-AzStorageContainer
[[-Name] <String>]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
ContainerPrefix
Get-AzStorageContainer
-Prefix <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Description
Get-AzStorageContainer Cmdlet 會列出與 Azure 中儲存體帳戶相關聯的儲存體容器。
範例
範例 1：依名稱取得 Azure 儲存體容器
Get-AzStorageContainer -Name container*
此範例使用萬用字元來傳回名稱以容器開頭的所有容器清單。
範例 2：依容器名稱前置詞取得 Azure 儲存體容器
Get-AzStorageContainer -Prefix "container"
此範例使用 Prefix 參數來傳回名稱以容器開頭的所有容器清單。
範例 3：列出 Azure 儲存體容器，包含已刪除的容器
$containers = Get-AzStorageContainer -IncludeDeleted -Context $ctx
$containers
Storage Account Name: storageaccountname
Name PublicAccess LastModified IsDeleted VersionId
---- ------------ ------------ --------- ---------
testcon Off 8/28/2020 10:18:13 AM +00:00
testcon2 9/4/2020 12:52:37 PM +00:00 True 01D67D248986B6DA
$c[1].BlobContainerProperties
LastModified : 9/4/2020 12:52:37 PM +00:00
LeaseStatus : Unlocked
LeaseState : Expired
LeaseDuration :
PublicAccess :
HasImmutabilityPolicy : False
HasLegalHold : False
DefaultEncryptionScope : $account-encryption-key
PreventEncryptionScopeOverride : False
DeletedOn : 9/8/2020 4:29:59 AM +00:00
RemainingRetentionDays : 299
ETag : "0x8D850D167059285"
Metadata : {}
此範例會列出儲存體帳戶的所有容器，包括已刪除的容器。
然後顯示已刪除的容器屬性，包括：DeletedOn、RemainingRetentionDays。
刪除的容器只有在使用 Enable-AzStorageBlobDeleteRetentionPolicy 啟用容器軟刪除之後才會存在。
參數
-ClientTimeoutPerRequest
指定一個服務要求的用戶端逾時間隔 （以秒為單位）。
如果上一個呼叫在指定的間隔內失敗，則此 Cmdlet 會重試要求。
如果此 Cmdlet 在間隔經過之前未收到成功的回應，則此 Cmdlet 會傳回錯誤。
參數屬性
| 類型: | Nullable<T>[Int32]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ClientTimeoutPerRequestInSeconds |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConcurrentTaskCount
指定並行網路呼叫數上限。
您可以使用此參數來限制並行，以指定並行網路呼叫數目上限，以節流本機 CPU 和頻寬使用量。
指定的值是絕對計數，不會乘以核心計數。
此參數有助於減少低頻寬環境下的網路連線問題，例如每秒 100 KB。
預設值為 10。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Context
指定儲存環境定義。
若要建立它，您可以使用 New-AzStorageContext Cmdlet。
當您使用從 SAS 權杖建立的儲存體內容時，將不會擷取容器許可權，因為查詢容器許可權需要儲存體帳戶金鑰許可權。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ContinuationToken
指定 Blob 清單的接續權杖。
參數屬性
| 類型: | Microsoft.Azure.Storage.Blob.BlobContinuationToken
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeDeleted
包含已刪除的容器，預設情況下，清單容器不會包含已刪除的容器
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaxCount
指定此 Cmdlet 傳回的物件數目上限。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定容器名稱。
如果容器名稱是空的，Cmdlet 會列出所有容器。
否則，它會列出符合指定名稱或一般名稱模式的所有容器。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
| 別名: | N, 容器 |
參數集
ContainerName
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Prefix
指定您要取得的一或多個容器名稱中使用的前置詞。
您可以使用它來尋找所有以相同字串開頭的容器，例如「my」或「test」。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ContainerPrefix
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ServerTimeoutPerRequest
指定要求的服務端逾時間隔 （以秒為單位）。
如果在服務處理要求之前經過指定的間隔，儲存體服務會傳回錯誤。
參數屬性
| 類型: | Nullable<T>[Int32]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ServerTimeoutPerRequestInSeconds |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
