你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzStorageContainerAcl

设置对存储容器的公共访问权限。

语法

Set-AzStorageContainerAcl
   [-Name] <String>
   [-Permission] <BlobContainerPublicAccessType>
   [-PassThru]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

说明

Set-AzStorageContainerAcl cmdlet 设置对 Azure 中指定存储容器的公共访问权限。

示例

示例 1:按名称设置 Azure 存储容器 ACL

Set-AzStorageContainerAcl -Container "Container01" -Permission Off -PassThru

此命令创建没有公共访问权限的容器。

示例 2:使用管道设置 Azure 存储容器 ACL

Get-AzStorageContainer container* | Set-AzStorageContainerAcl -Permission Blob -PassThru

此命令获取名称以容器开头的所有存储容器,然后在管道上传递结果以设置所有存储容器对 Blob 访问的权限。

参数

-ClientTimeoutPerRequest

指定一个服务请求的客户端超时间隔(以秒为单位)。 如果上一次调用在指定的时间间隔内失败,则此 cmdlet 将重试请求。 如果此 cmdlet 在间隔过前未收到成功的响应,则此 cmdlet 将返回错误。

类型:Nullable<T>[Int32]
别名:ClientTimeoutPerRequestInSeconds
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConcurrentTaskCount

指定最大并发网络调用数。 可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。 指定的值是绝对计数,不乘以核心计数。 此参数可帮助减少低带宽环境中的网络连接问题,例如每秒 100 千比特。 默认值为 10。

类型:Nullable<T>[Int32]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Context

指定 Azure 存储上下文。 可以使用 New-AzStorageContext cmdlet 创建它。

类型:IStorageContext
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定容器名称。

类型:String
别名:N, Container
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PassThru

返回一个代表你所处理的项目的对象。 默认情况下,此 cmdlet 将不产生任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Permission

指定对此容器的公共访问级别。 默认情况下,容器及其中的任何 blob 只能由存储帐户的所有者访问。 若要向匿名用户授予对容器及其 Blob 的读取权限,可以设置容器权限以启用公共访问。 匿名用户可以读取公开可用的容器中的 Blob,而无需对请求进行身份验证。 此参数的可接受值为:--Container。 提供对容器及其 Blob 的完整读取访问权限。 客户端可以通过匿名请求枚举容器中的 blob,但不能枚举存储帐户中的容器。 --Blob。 通过匿名请求提供对容器中 Blob 数据的读取访问权限,但不提供对容器数据的访问权限。 客户端无法使用匿名请求枚举容器中的 blob。 --Off。 仅限制对存储帐户所有者的访问。

类型:BlobContainerPublicAccessType
别名:PublicAccess
接受的值:Off, Container, Blob, Unknown
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ServerTimeoutPerRequest

指定请求的服务端超时间隔(以秒为单位)。 如果服务处理请求之前指定的间隔已过,则存储服务将返回错误。 服务器端为每个请求超时。

类型:Nullable<T>[Int32]
别名:ServerTimeoutPerRequestInSeconds
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

IStorageContext

输出

AzureStorageContainer