你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzureStorageContainerSASToken
生成 Azure 存储容器的 SAS 令牌。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。
语法
New-AzureStorageContainerSASToken
[-Name] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[<CommonParameters>]
New-AzureStorageContainerSASToken
[-Name] <String>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[<CommonParameters>]
说明
New-AzureStorageContainerSASToken cmdlet 为 Azure 存储容器生成共享访问签名 (SAS) 令牌。
示例
示例 1:生成具有完整容器权限的容器 SAS 令牌
PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Permission rwdl
此示例生成具有完整容器权限的容器 SAS 令牌。
示例 2:按管道生成多个容器 SAS 令牌
PS C:\>Get-AzureStorageContainer -Container test* | New-AzureStorageContainerSASToken -Permission rwdl
此示例使用管道生成多个容器 SAS 令牌。
示例 3:使用共享访问策略生成容器 SAS 令牌
PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Policy "PolicyName"
此示例生成具有共享访问策略的容器 SAS 令牌。
参数
-Context
指定 Azure 存储上下文。 可以使用 New-AzureStorageContext cmdlet 创建它。
类型: | IStorageContext |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ExpiryTime
指定共享访问签名失效的时间。
如果用户设置开始时间而不是到期时间,则到期时间设置为开始时间加上一小时。 如果既未指定开始时间和到期时间,则将到期时间设置为当前时间加上一小时。
类型: | 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
指定存储容器的权限。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Policy
指定 Azure 存储访问策略。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Protocol
指定请求允许的协议。 此参数的可接受值为:
- HttpsOnly
- HttpsOrHttp
默认值为 HttpsOrHttp。
类型: | SharedAccessProtocol |
接受的值: | HttpsOnly, HttpsOrHttp |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-StartTime
指定共享访问签名生效的时间。
类型: | DateTime |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |