New-AzStorageBlobSASToken

模組:

Az.Storage

產生 Azure 記憶體 Blob 的 SAS 令牌。

語法

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>]

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

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>]

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>]

Description

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
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-BlobBaseClient

BlobBaseClient 物件

類型:	BlobBaseClient
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-CloudBlob

指定 CloudBlob 物件。 若要取得 CloudBlob 物件，請使用 Get-AzStorageBlob Cmdlet。

類型:	CloudBlob
別名:	ICloudBlob
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Container

指定記憶體容器名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Context

指定記憶體內容。 當記憶體內容以 OAuth 驗證為基礎時，會產生使用者身分識別 Blob SAS 令牌。

類型:	IStorageContext
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EncryptionScope

傳送具有此SAS URI授權的要求時要使用的加密範圍。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExpiryTime

指定共用存取簽章到期的時間。 當記憶體內容以 OAuth 驗證為基礎時，到期時間必須介於 7 天內，且不得早於目前時間。

類型:	Nullable<T>[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.5.60-168.1.5.70。 範圍是內含的。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Permission

指定記憶體 Blob 的許可權。 請務必注意，這是字串，例如 rwd （針對讀取、寫入和刪除）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Policy

指定 Azure 預存存取原則。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Protocol

指定要求允許的通訊協定。 此參數可接受的值為：

• HttpsOnly
• HttpsOrHttp 預設值為 HttpsOrHttp。

類型:	Nullable<T>[SharedAccessProtocol]
接受的值:	HttpsOnly, HttpsOrHttp
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StartTime

指定共用存取簽章生效的時間。

類型:	Nullable<T>[DateTime]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

CloudBlob

IStorageContext

輸出

String

相關連結

• Get-AzStorageBlob
• New-AzStorageContainerSASToken