你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureStorageShareSASToken
为Azure 存储共享生成共享访问签名令牌。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
New-AzureStorageShareSASToken
[-ShareName] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureStorageShareSASToken
[-ShareName] <String>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
New-Azure存储ShareSASToken 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-Azure存储Context 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 |
-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
指定令牌中访问共享和共享下文件的权限。
请务必注意，这是一个字符串，例如 rwd （对于读取、写入和删除）。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Policy
指定共享的存储访问策略。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Protocol
指定请求允许的协议。 此参数的可接受值为：
- HttpsOnly
- HttpsOrHttp 默认值为 HttpsOrHttp。
| 类型: | Nullable<T>[SharedAccessProtocol] |
| 接受的值: | HttpsOnly, HttpsOrHttp |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ShareName
指定存储共享的名称。
| 类型: | String |
| 别名: | N, Name |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-StartTime
指定共享访问签名生效的时间。
| 类型: | Nullable<T>[DateTime] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
输出
备注
- 关键字：common， azure， services， data， storage， blob， queue， table