你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzureStorageShareSASToken
为Azure 存储共享生成共享访问签名令牌。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。
语法
New-AzureStorageShareSASToken
[-ShareName] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[<CommonParameters>]
New-AzureStorageShareSASToken
[-ShareName] <String>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[<CommonParameters>]
说明
New-AzureStorageShareSASToken cmdlet 为Azure 存储共享生成共享访问签名令牌。
示例
示例 1:为共享生成共享访问签名令牌
PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"
此命令为名为 ContosoShare 的共享创建共享访问签名令牌。
示例 2:使用管道生成多个共享访问签名令牌
PS C:\>Get-AzureStorageShare -Prefix "test" | New-AzureStorageShareSASToken -Permission "rwdl"
此命令获取与前缀测试匹配的所有存储共享。 该命令使用管道运算符将它们传递到当前 cmdlet。 当前 cmdlet 为具有指定权限的每个存储共享创建共享访问令牌。
示例 3:生成使用共享访问策略的共享访问签名令牌
PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"
此命令为名为 ContosoShare 的存储共享创建共享访问签名令牌,该共享具有名为 ContosoPolicy03 的策略。
参数
-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 |
-Permission
指定令牌中访问共享和共享下文件的权限。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Policy
指定共享的存储访问策略。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Protocol
指定请求允许的协议。 此参数的可接受值为:
- HttpsOnly
- HttpsOrHttp
默认值为 HttpsOrHttp。
类型: | SharedAccessProtocol |
接受的值: | HttpsOnly, HttpsOrHttp |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ShareName
指定存储共享的名称。
类型: | String |
别名: | N, Name |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-StartTime
指定共享访问签名生效的时间。
类型: | DateTime |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
备注
- 关键字:common, azure, services, data, storage, blob, queue, table