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

New-AzureStorageTableSASToken

为Azure 存储表生成 SAS 令牌。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

New-AzureStorageTableSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-StartPartitionKey <String>]
   [-StartRowKey <String>]
   [-EndPartitionKey <String>]
   [-EndRowKey <String>]
   [-Context <IStorageContext>]
   [<CommonParameters>]
New-AzureStorageTableSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-StartPartitionKey <String>]
   [-StartRowKey <String>]
   [-EndPartitionKey <String>]
   [-EndRowKey <String>]
   [-Context <IStorageContext>]
   [<CommonParameters>]

说明

New-AzureStorageTableSASToken cmdlet 为Azure 存储表生成共享访问签名 (SAS) 令牌。

示例

示例 1:生成对表具有完全权限的 SAS 令牌

C:\PS>New-AzureStorageTableSASToken -Name "ContosoResources" -Permission "raud"

此命令为名为 ContosoResources 的表生成具有完全权限的 SAS 令牌。 该令牌用于读取、添加、更新和删除权限。

示例 2:为一系列分区生成 SAS 令牌

C:\PS>New-AzureStorageTableSASToken -Name "ContosoResources" -Permission "raud" -StartPartitionKey "a" -EndPartitionKey "b"

此命令为名为 ContosoResources 的表生成具有完全权限的 SAS 令牌。 该命令将令牌限制为 StartPartitionKey 和 EndPartitionKey 参数指定的范围

示例 3:生成具有表存储访问策略的 SAS 令牌

C:\PS>New-AzureStorageTableSASToken -Name "ContosoResources" -Policy "ClientPolicy01"

此命令为名为 ContosoResources 的表生成 SAS 令牌。 该命令指定名为 ClientPolicy01 的存储访问策略。

参数

-Context

指定 Azure 存储上下文。 若要获取存储上下文,请使用 New-AzureStorageContext cmdlet。

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

-EndPartitionKey

指定此 cmdlet 创建的标记范围的末尾的分区键。

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

-EndRowKey

指定此 cmdlet 创建的标记范围的末尾的行键。

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

-ExpiryTime

指定 SAS 令牌过期的时间。

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

-FullUri

指示此 cmdlet 返回包含 SAS 令牌的完整队列 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 存储表的名称。 此 cmdlet 为此参数指定的表创建 SAS 令牌。

类型:String
别名:N, Table
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Permission

指定Azure 存储表的权限。

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

-Policy

指定存储的访问策略,其中包括此 SAS 令牌的权限。

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

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp

默认值为 HttpsOrHttp。

类型:SharedAccessProtocol
接受的值:HttpsOnly, HttpsOrHttp
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StartPartitionKey

指定此 cmdlet 创建的标记范围的开头的分区键。

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

-StartRowKey

指定此 cmdlet 创建的标记范围的开头的行键。

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

-StartTime

指定 SAS 令牌何时生效。

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