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>]
说明
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。
只有在启用了容器 softdelete 且已启用 Enable-AzStorageBlobDeleteRetentionPolicy 后，已删除的容器才会存在。
参数
-ClientTimeoutPerRequest
指定一个服务请求的客户端超时间隔（以秒为单位）。
如果上一次调用在指定的时间间隔内失败，则此 cmdlet 将重试请求。
如果此 cmdlet 在间隔过前未收到成功的响应，则此 cmdlet 将返回错误。
参数属性
| 类型: | Nullable<T>[Int32]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | ClientTimeoutPerRequestInSeconds |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConcurrentTaskCount
指定最大并发网络调用数。
可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。
指定的值是绝对计数，不乘以核心计数。
此参数可帮助减少低带宽环境中的网络连接问题，例如每秒 100 千比特。
默认值为 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。
输出
