New-AzStorageFileSASToken
ストレージ ファイルの Shared Access Signature トークンを生成します。
構文
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
New-AzStorageFileSASToken コマンドレットは、Azure Storage ファイルの Shared Access Signature トークンを生成します。
例
例 1: ファイルの完全なアクセス許可を持つ Shared Access Signature トークンを生成する
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"
このコマンドは、FilePath という名前のファイルに対する完全なアクセス許可を持つ Shared Access Signature トークンを生成します。
例 2: 制限時間がある Shared Access Signature トークンを生成する
$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime
最初のコマンドは、Get-Date コマンドレットを使用して、DateTime オブジェクトを作成します。 このコマンドは、現在の時刻を$StartTime変数に格納します。 2 番目のコマンドは、$StartTime内のオブジェクトに 2 時間を追加し、結果を $EndTime 変数に格納します。 このオブジェクトは、2 時間後の時刻です。 3 番目のコマンドは、指定されたアクセス許可を持つ Shared Access Signature トークンを生成します。 このトークンは、現在の時刻に有効になります。 トークンは、$EndTimeに格納されるまで有効なままです。
パラメーター
-Context
Azure Storage コンテキストを指定します。 コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。
型: | IStorageContext |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExpiryTime
Shared Access Signature が無効になる時刻を指定します。
型: | 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 |
-Path
ストレージ共有に対するファイルの相対パスを指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Permission
ストレージ ファイルのアクセス許可を指定します。
これは rwd
のような文字列であることに注意してください (読み取り、書き込み、削除の場合)。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Policy
ファイルに格納されているアクセス ポリシーを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Protocol
要求に許可されるプロトコルを指定します。 このパラメーターに使用できる値は次のとおりです。
- HttpsOnly
- HttpsOrHttp 既定値は HttpsOrHttp です。
型: | String |
指定可能な値: | HttpsOnly, HttpsOrHttp |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ShareFileClient
SAS トークンを取得する対象のファイルを表す ShareFileClient インスタンス。
型: | ShareFileClient |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ShareName
ストレージ共有の名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StartTime
Shared Access Signature が有効になる時刻を指定します。
型: | Nullable<T>[DateTime] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell