通过

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

New-AzStorageShareSASToken

模块:
Az.Storage Module

为 Azure 存储共享生成共享访问签名令牌。

语法

SasPolicy 

New-AzStorageShareSASToken
    [-ShareName] <String>
    -Policy <String>
    [-Protocol <String>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SasPermission 

New-AzStorageShareSASToken
    [-ShareName] <String>
    [-Permission <String>]
    [-Protocol <String>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

New-AzStorageShareSASToken cmdlet 为 Azure 存储共享生成共享访问签名令牌。

示例

示例 1：为共享生成共享访问签名令牌

New-AzStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

此命令为名为 ContosoShare 的共享创建共享访问签名令牌。

示例 2：使用管道生成多个共享访问签名令牌

Get-AzStorageShare -Prefix "test" | New-AzStorageShareSASToken -Permission "rwdl"

此命令获取与前缀测试匹配的所有存储共享。 该命令使用管道运算符将它们传递到当前 cmdlet。 当前 cmdlet 为具有指定权限的每个存储共享创建共享访问令牌。

示例 3：生成使用共享访问策略的共享访问签名令牌

New-AzStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

此命令为名为 ContosoShare 的存储共享创建共享访问签名令牌，该共享具有名为 ContosoPolicy03 的策略。

参数

-Context

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

参数属性

类型:IStorageContext
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExpiryTime

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

参数属性

类型:

Nullable<T>[DateTime]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FullUri

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IPAddressOrRange

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Permission

指定令牌中访问共享和共享下文件的权限。 请务必注意，这是一个字符串，例如 rwd （对于读取、写入和删除）。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SasPermission
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Policy

指定共享的存储访问策略。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SasPolicy
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp 默认值为 HttpsOrHttp。

参数属性

类型:String
默认值:None
接受的值:HttpsOnly, HttpsOrHttp
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ShareName

指定存储共享的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:N, Name

参数集

(All)
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-StartTime

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

参数属性

类型:

Nullable<T>[DateTime]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

String

IStorageContext

输出

String

备注

  • 关键字：common， azure， services， data， storage， blob， queue， table