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

New-AzStorageBlobSASToken

模块:: Az.Storage Module

为 Azure 存储 Blob 生成 SAS 令牌。

语法

BlobNameWithPermission （默认值）

New-AzStorageBlobSASToken
    [-Container] <String>
    [-Blob] <String>
    [-Permission <String>]
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipelineWithPolicy

New-AzStorageBlobSASToken
    -CloudBlob <CloudBlob>
    -Policy <String>
    [-BlobBaseClient <BlobBaseClient>]
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipelineWithPermission

New-AzStorageBlobSASToken
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-Permission <String>]
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobNameWithPolicy

New-AzStorageBlobSASToken
    [-Container] <String>
    [-Blob] <String>
    -Policy <String>
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzStorageBlobSASToken cmdlet 为 Azure 存储 Blob 生成共享访问签名（SAS）令牌。

示例

示例 1：生成具有完整 Blob 权限的 Blob SAS 令牌

New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd

此示例生成具有完整 Blob 权限的 Blob SAS 令牌。

示例 2：生成具有生存时间的 Blob SAS 令牌

$StartTime = Get-Date
$EndTime = $startTime.AddHours(2.0)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime

此示例生成具有生存时间的 Blob SAS 令牌。

示例 3：使用基于 OAuth 身份验证的存储上下文生成用户标识 SAS 令牌

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -Context $ctx

此示例基于 OAuth 身份验证生成具有存储上下文的用户标识 Blob SAS 令牌

参数

-Blob

指定存储 Blob 名称。

参数属性

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

参数集

BlobNameWithPermission

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

BlobNameWithPolicy

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

-BlobBaseClient

BlobBaseClient 对象

参数属性

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

参数集

BlobPipelineWithPolicy

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

BlobPipelineWithPermission

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

-CloudBlob

指定 CloudBlob 对象。若要获取 CloudBlob 对象，请使用 Get-AzStorageBlob cmdlet。

参数属性

类型:	Microsoft.Azure.Storage.Blob.CloudBlob
默认值:	None
支持通配符:	False
不显示:	False
别名:	ICloudBlob

参数集

BlobPipelineWithPolicy

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

BlobPipelineWithPermission

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

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

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

参数集

(All)

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

-Container

指定存储容器名称。

参数属性

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

参数集

BlobNameWithPermission

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

BlobNameWithPolicy

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

-Context

指定存储上下文。当存储上下文基于 OAuth 身份验证时，将生成用户标识 Blob SAS 令牌。

参数属性

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

-EncryptionScope

发送经此 SAS URI 授权的请求时要使用的加密范围。

参数属性

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

参数集

(All)

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

-ExpiryTime

指定共享访问签名过期的时间。当存储上下文基于 OAuth 身份验证时，过期时间必须介于 7 天内，并且不得早于当前时间。

参数属性

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

指定存储 Blob 的权限。请务必注意，这是一个字符串，例如 rwd （对于读取、写入和删除）。

参数属性

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

参数集

BlobNameWithPermission

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

BlobPipelineWithPermission

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

-Policy

指定 Azure 存储访问策略。

参数属性

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

参数集

BlobPipelineWithPolicy

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

BlobNameWithPolicy

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

-Protocol

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

HttpsOnly
HttpsOrHttp 默认值为 HttpsOrHttp。

参数属性

类型:	Nullable<T>[Microsoft.Azure.Storage.SharedAccessProtocol]
默认值:	None
接受的值:	HttpsOnly, HttpsOrHttp
支持通配符:	False
不显示:	False

参数集

(All)

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

-StartTime

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

参数属性

类型:	Nullable<T>[DateTime]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	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。

通过

New-AzStorageBlobSASToken

语法

BlobNameWithPermission （默认值）

BlobPipelineWithPolicy

BlobPipelineWithPermission

BlobNameWithPolicy

说明

示例

示例 1：生成具有完整 Blob 权限的 Blob SAS 令牌

示例 2：生成具有生存时间的 Blob SAS 令牌

示例 3：使用基于 OAuth 身份验证的存储上下文生成用户标识 SAS 令牌

参数

-Blob

参数属性

参数集

-BlobBaseClient

参数属性

参数集

-CloudBlob

参数属性

参数集

-Confirm

参数属性

参数集

-Container

参数属性

参数集

-Context

参数属性

参数集

-DefaultProfile

参数属性

参数集

-EncryptionScope

参数属性

参数集

-ExpiryTime

参数属性

参数集

-FullUri

参数属性

参数集

-IPAddressOrRange

参数属性

参数集

-Permission

参数属性

参数集

-Policy

参数属性

参数集

-Protocol

参数属性

参数集

-StartTime

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

输出

String

相关链接

反馈