你当前正在访问 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