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

New-AzStorageContainerSASToken

模块:

Az.Storage

为 Azure 存储容器生成 SAS 令牌。

语法

New-AzStorageContainerSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStorageContainerSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzStorageContainerSASToken cmdlet 为 Azure 存储容器生成共享访问签名 （SAS） 令牌。

示例

示例 1：生成具有完整容器权限的容器 SAS 令牌

New-AzStorageContainerSASToken -Name "Test" -Permission rwdl

此示例生成具有完整容器权限的容器 SAS 令牌。

示例 2：按管道生成多个容器 SAS 令牌

Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -Permission rwdl

此示例使用管道生成多个容器 SAS 令牌。

示例 3：使用共享访问策略生成容器 SAS 令牌

New-AzStorageContainerSASToken -Name "Test" -Policy "PolicyName"

此示例生成具有共享访问策略的容器 SAS 令牌。

示例 3：使用基于 OAuth 身份验证的存储上下文生成用户标识容器 SAS 令牌

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageContainerSASToken -Name "ContainerName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -context $ctx

此示例基于 OAuth 身份验证生成具有存储上下文的用户标识容器 SAS 令牌

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

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

-Context

指定 Azure 存储上下文。 可以使用 New-AzStorageContext cmdlet 创建它。 当存储上下文基于 OAuth 身份验证时，将生成用户标识容器 SAS 令牌。

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

-DefaultProfile

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

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

-EncryptionScope

发送经此 SAS URI 授权的请求时要使用的加密范围。

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

-ExpiryTime

指定共享访问签名失效的时间。 如果用户设置开始时间而不是到期时间，则到期时间设置为开始时间加上一小时。 如果既未指定开始时间和到期时间，则将到期时间设置为当前时间加上一小时。 当存储上下文基于 OAuth 身份验证时，过期时间必须介于 7 天内，并且不得早于当前时间。

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

-FullUri

指示此 cmdlet 返回完整的 Blob URI 和共享访问签名令牌。

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

-IPAddressOrRange

指定要从中接受请求的 IP 地址或 IP 地址范围，例如 168.1.5.65 或 168.1.5.60-168.1.5.70。 范围是非独占的。

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

-Name

指定 Azure 存储容器名称。

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

-Permission

指定存储容器的权限。 请务必注意，这是一个字符串，如 rwd（对于读取、写入和删除）。 此处 介绍了容器资源类型支持的权限。

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

-Policy

指定 Azure 存储访问策略。

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

-Protocol

指定请求允许的协议。 此参数的可接受值为：

• HttpsOnly
• HttpsOrHttp 默认值为 HttpsOrHttp。

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

-StartTime

指定共享访问签名生效的时间。

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

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

输入

String

IStorageContext

输出

String

相关链接

• New-AzStorageBlobSASToken