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

New-AzureStorageContainerSASToken

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

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 Az PowerShell 模块

语法

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 创建它。

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExpiryTime

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

如果用户设置开始时间而不是到期时间,则到期时间设置为开始时间加上一小时。 如果既未指定开始时间和到期时间,则将到期时间设置为当前时间加上一小时。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullUri

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddressOrRange

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定 Azure 存储容器名称。

Type:String
Aliases:N, Container
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Permission

指定存储容器的权限。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

指定 Azure 存储访问策略。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp

默认值为 HttpsOrHttp。

Type:SharedAccessProtocol
Accepted values:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False