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

New-AzureStorageContainerStoredAccessPolicy

为 Azure 存储容器创建存储访问策略。

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行,但不再受到维护或支持,任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

New-AzureStorageContainerStoredAccessPolicy
   [-Container] <String>
   [-Policy] <String>
   [-Permission <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

说明

New-AzureStorageContainerStoredAccessPolicy cmdlet 为 Azure 存储容器创建存储访问策略。

示例

示例 1:在存储容器中创建存储访问策略

PS C:\>New-AzureStorageContainerStoredAccessPolicy -Container "MyContainer" -Policy "Policy01"

此命令在名为 MyContainer 的存储容器中创建名为 Policy01 的访问策略。

参数

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Container

指定 Azure 存储容器名称。

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

-Context

指定 Azure 存储上下文。 若要获取存储上下文,请使用 New-AzureStorageContext cmdlet。

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

-DefaultProfile

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

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

-ExpiryTime

指定存储访问策略失效的时间。

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

-Permission

指定存储访问策略中用于访问容器的权限。 请务必注意,这是一个字符串,例如 rwd (对于读取、写入和删除)。

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

-Policy

指定存储的访问策略,其中包括此 SAS 令牌的权限。

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

-ServerTimeoutPerRequest

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

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

-StartTime

指定存储访问策略生效的时间。

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

输入

String

IStorageContext

输出

String