New-AzStorageBlobSASToken
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>]
説明
New-AzStorageBlobSASToken コマンドレットは、Azure ストレージ BLOB の Shared Access Signature (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 認証に基づいてストレージ コンテキストを使用してユーザー ID 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 認証に基づいてストレージ コンテキストを持つユーザー ID BLOB SAS トークンを生成します
パラメーター
-Blob
ストレージ BLOB 名を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BlobBaseClient
BlobBaseClient オブジェクト
型: | BlobBaseClient |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-CloudBlob
CloudBlob オブジェクトを指定します。 CloudBlob オブジェクトを取得するには、Get-AzStorageBlob コマンドレットを使用します。
型: | CloudBlob |
Aliases: | ICloudBlob |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Container
ストレージ コンテナー名を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Context
ストレージ コンテキストを指定します。 ストレージ コンテキストが OAuth 認証に基づいている場合、ユーザー ID BLOB SAS トークンが生成されます。
型: | IStorageContext |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EncryptionScope
この SAS URI で承認された要求を送信するときに使用する暗号化スコープ。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExpiryTime
Shared Access Signature の有効期限を指定します。 ストレージ コンテキストが OAuth 認証に基づいている場合、有効期限は現在の時刻から 7 日でなければならず、現在の時刻より前にすることはできません。
型: | Nullable<T>[DateTime] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FullUri
このコマンドレットが完全な BLOB URI と Shared Access Signature トークンを返すように指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IPAddressOrRange
168.1.5.65 や 168.1.5.60-168.1.5.70 など、要求を受け入れる IP アドレスまたは IP アドレスの範囲を指定します。 範囲は包括的です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Permission
ストレージ BLOB のアクセス許可を指定します。
これは rwd
のような文字列であることに注意してください (読み取り、書き込み、削除の場合)。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Policy
Azure ストアド アクセス ポリシーを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Protocol
要求に許可されるプロトコルを指定します。 このパラメーターの有効値は、次のとおりです。
- HttpsOnly
- HttpsOrHttp 既定値は HttpsOrHttp です。
型: | Nullable<T>[SharedAccessProtocol] |
指定可能な値: | HttpsOnly, HttpsOrHttp |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StartTime
Shared Access Signature が有効になる時刻を指定します。
型: | Nullable<T>[DateTime] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell