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

New-AzStorageAccountSASToken

创建帐户级 SAS 令牌。

语法

New-AzStorageAccountSASToken
   -Service <SharedAccessAccountServices>
   -ResourceType <SharedAccessAccountResourceTypes>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzStorageAccountSASToken cmdlet 为Azure 存储帐户创建帐户级共享访问签名 (SAS) 令牌。 可以使用 SAS 令牌委托多个服务的权限,或委托对象级 SAS 令牌不可用的服务的权限。 使用存储帐户密钥保护帐户 SAS。 若要创建帐户 SAS,客户端应用程序必须拥有帐户密钥。

示例

示例 1:创建具有完全权限的帐户级 SAS 令牌

New-AzStorageAccountSASToken -Service Blob,File,Table,Queue -ResourceType Service,Container,Object -Permission "racwdlup"

此命令创建具有完全权限的帐户级 SAS 令牌。

示例 2:为一系列 IP 地址和 EncryptionScope 创建帐户级 SAS 令牌

New-AzStorageAccountSASToken -Service Blob,File,Table,Queue -ResourceType Service,Container,Object -Permission "racwdlup" -Protocol HttpsOnly -IPAddressOrRange 168.1.5.60-168.1.5.70 -EncryptionScope scopename

此命令使用特定的 EncryptionScope 为来自指定 IP 地址范围的仅限 HTTPS 的请求创建帐户级 SAS 令牌。

示例 3:创建有效期为 24 小时的帐户级 SAS 令牌

New-AzStorageAccountSASToken -Service Blob -ResourceType Service,Container,Object -Permission "rl" -ExpiryTime (Get-Date).AddDays(1)

此命令创建一个只读帐户级 SAS 令牌,该令牌有效期为 24 小时。

参数

-Context

指定 Azure 存储上下文。 可以使用 New-AzStorageContext cmdlet 获取 AzureStorageContext 对象。

类型: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

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

类型:Nullable<T>[DateTime]
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 (对于读取、写入和删除)。 有关可接受的权限值的详细信息,请参阅构造帐户 SAS http://go.microsoft.com/fwlink/?LinkId=799514

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

-Protocol

指定允许用于使用帐户 SAS 发出的请求的协议。 此参数的可接受值为:

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

-ResourceType

指定可用于 SAS 令牌的资源类型。 此参数的可接受值为:

  • 服务
  • 容器
  • Object
类型:SharedAccessAccountResourceTypes
接受的值:None, Service, Container, Object
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Service

指定服务。 此参数的可接受值为:

  • Blob
  • 文件
  • 队列
类型:SharedAccessAccountServices
接受的值:None, Blob, File, Queue, Table
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-StartTime

将 SAS 生效的时间指定为 DateTime 对象。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。

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

输入

IStorageContext

输出

String