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

Set-AzureStorageContainerAcl

参考

模块:: Azure.Storage

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

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器（ARM）资源。

语法

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

说明

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

示例

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

PS C:\>Set-AzureStorageContainerAcl -Container "Container01" -Permission Off -PassThru

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

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

PS C:\>Get-AzureStorageContainer container* | Set-AzureStorageContainerAcl -Permission Blob -PassThru

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

参数

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Context

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

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

-Name

指定容器名称。

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

-PassThru

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

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

-Permission

指定对此容器的公共访问级别。默认情况下，容器及其中的任何 blob 只能由存储帐户的所有者访问。若要向匿名用户授予对容器及其 Blob 的读取权限，可以设置容器权限以启用公共访问。匿名用户可以读取公开可用的容器中的 Blob，而无需对请求进行身份验证。此参数的可接受值为：

--容器。提供对容器及其 Blob 的完整读取访问权限。客户端可以通过匿名请求枚举容器中的 blob，但不能枚举存储帐户中的容器。 --Blob。通过匿名请求提供对容器中 Blob 数据的读取访问权限，但不提供对容器数据的访问权限。客户端无法使用匿名请求枚举容器中的 blob。 --Off。仅限制对存储帐户所有者的访问。

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

-ServerTimeoutPerRequest

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

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

通过