New-AzureStorageContainerSASToken

Azure ストレージ コンテナーの SAS トークンを生成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureStorageContainerSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageContainerSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzureStorageContainerSASToken コマンドレットは、Azure ストレージ コンテナーの Shared Access Signature (SAS) トークンを生成します。

例 1: 完全なコンテナー アクセス許可を持つコンテナー SAS トークンを生成する

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Permission rwdl

この例では、完全なコンテナー アクセス許可を持つコンテナー SAS トークンを生成します。

例 2: パイプラインによって複数のコンテナー SAS トークンを生成する

PS C:\>Get-AzureStorageContainer -Container test* | New-AzureStorageContainerSASToken -Permission rwdl

この例では、パイプラインを使用して複数のコンテナー SAS トークンを生成します。

例 3: 共有アクセス ポリシーを使用してコンテナー SAS トークンを生成する

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Policy "PolicyName"

この例では、共有アクセス ポリシーを使用してコンテナー SAS トークンを生成します。

パラメーター

-Context

Azure ストレージ コンテキストを指定します。 New-AzureStorageContext コマンドレットを使用して作成できます。

型:IStorageContext
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExpiryTime

Shared Access Signature が無効になる時刻を指定します。 ユーザーが開始時刻を設定したが、有効期限を設定しない場合、有効期限は開始時刻と 1 時間に設定されます。 開始時刻も有効期限も指定されていない場合、有効期限は現在の時刻に 1 時間を加えた値に設定されます。

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

-Name

Azure ストレージ コンテナー名を指定します。

型:String
Aliases:N, Container
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Permission

ストレージ コンテナーのアクセス許可を指定します。 これは (読み取り、書き込み、削除の場合) のような 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

入力

String

IStorageContext

出力

String