New-AzStorageContainerSASToken
Azure ストレージ コンテナーの SAS トークンを生成します。
構文
SasPolicy
New-AzStorageContainerSASToken
[-Name] <String>
-Policy <String>
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-EncryptionScope <String>]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SasPermission
New-AzStorageContainerSASToken
[-Name] <String>
[-Permission <String>]
[-Protocol <SharedAccessProtocol>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-EncryptionScope <String>]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzStorageContainerSASToken コマンドレットは、Azure ストレージ コンテナーの Shared Access Signature (SAS) トークンを生成します。
例
例 1: 完全なコンテナー アクセス許可を持つコンテナー SAS トークンを生成する
New-AzStorageContainerSASToken -Name "Test" -Permission rwdl
この例では、完全なコンテナー アクセス許可を持つコンテナー SAS トークンを生成します。
例 2: パイプラインによって複数のコンテナー SAS トークンを生成する
Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -Permission rwdl
この例では、パイプラインを使用して複数のコンテナー SAS トークンを生成します。
例 3: 共有アクセス ポリシーを使用してコンテナー SAS トークンを生成する
New-AzStorageContainerSASToken -Name "Test" -Policy "PolicyName"
この例では、共有アクセス ポリシーを使用してコンテナー SAS トークンを生成します。
例 3: OAuth 認証に基づいてストレージ コンテキストを使用してユーザー ID コンテナー SAS トークンを生成する
$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageContainerSASToken -Name "ContainerName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -context $ctx
この例では、OAuth 認証に基づいてストレージ コンテキストを持つユーザー ID コンテナー SAS トークンを生成します
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Context
Azure ストレージ コンテキストを指定します。
New-AzStorageContext コマンドレットを使用して作成できます。
ストレージ コンテキストが OAuth 認証に基づいている場合、ユーザー ID コンテナー SAS トークンが生成されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EncryptionScope
この SAS URI で承認された要求を送信するときに使用する暗号化スコープ。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExpiryTime
Shared Access Signature が無効になる時刻を指定します。
ユーザーが開始時刻を設定したが、有効期限を設定しない場合、有効期限は開始時刻と 1 時間に設定されます。
開始時刻も有効期限も指定されていない場合、有効期限は現在の時刻に 1 時間を加えた値に設定されます。
ストレージ コンテキストが OAuth 認証に基づいている場合、有効期限は現在の時刻から 7 日でなければならず、現在の時刻より前にすることはできません。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FullUri
このコマンドレットが完全な BLOB URI と Shared Access Signature トークンを返すように指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IPAddressOrRange
168.1.5.65 や 168.1.5.60-168.1.5.70 など、要求を受け入れる IP アドレスまたは IP アドレスの範囲を指定します。
範囲は包括的です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
Azure ストレージ コンテナー名を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | N, コンテナ |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Permission
ストレージ コンテナーのアクセス許可を指定します。
これは rwd のような文字列であることに注意してください (読み取り、書き込み、削除の場合)。 コンテナー リソースの種類でサポートされるアクセス許可については、説明します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SasPermission
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Policy
Azure ストアド アクセス ポリシーを指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SasPolicy
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Protocol
要求に許可されるプロトコルを指定します。
このパラメーターに使用できる値は次のとおりです。
- Httpsのみ
- HttpsOrHttp 既定値は HttpsOrHttp です。
パラメーターのプロパティ
| 型: | Nullable<T>[Microsoft.Azure.Storage.SharedAccessProtocol]
|
| 規定値: | None |
| 指定可能な値: | HttpsOnly, HttpsOrHttp |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StartTime
Shared Access Signature が有効になる時刻を指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力