New-AzureStorageShareSASToken

Azure Storage 共有の Shared Access Signature トークンを生成します。

警告

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

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

構文

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

説明

New-AzureStorageShareSASToken コマンドレットは、Azure Storage 共有の Shared Access Signature トークンを生成します。

例 1: 共有の Shared Access Signature トークンを生成する

PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

このコマンドは、ContosoShare という名前の共有の Shared Access Signature トークンを作成します。

例 2: パイプラインを使用して複数の Shared Access Signature トークンを生成する

PS C:\>Get-AzureStorageShare -Prefix "test" | New-AzureStorageShareSASToken -Permission "rwdl"

このコマンドは、プレフィックス テストに一致するすべてのストレージ共有を取得します。 コマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 現在のコマンドレットは、指定されたアクセス許可を持つ各ストレージ共有の共有アクセス トークンを作成します。

例 3: 共有アクセス ポリシーを使用する共有アクセス署名トークンを生成する

PS C:\>New-AzureStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

このコマンドは、ContosoPolicy03 という名前のポリシーを持つ ContosoShare という名前のストレージ共有の共有アクセス署名トークンを作成します。

パラメーター

-Context

Azure Storage コンテキストを指定します。 コンテキストを取得するには、New-AzureStorageContext コマンドレットを使用します。

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

-Permission

共有と共有の下のファイルにアクセスするためのトークン内のアクセス許可を指定します。 これは (読み取り、書き込み、削除の場合) のような rwd 文字列であることに注意してください。

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

-Policy

共有に格納されているアクセス ポリシーを指定します。

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

-Protocol

要求に許可されるプロトコルを指定します。 このパラメーターの有効値は、次のとおりです。

  • HttpsOnly
  • HttpsOrHttp 既定値は HttpsOrHttp です。
型:Nullable<T>[SharedAccessProtocol]
指定可能な値:HttpsOnly, HttpsOrHttp
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ShareName

ストレージ共有の名前を指定します。

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

-StartTime

Shared Access Signature が有効になる時刻を指定します。

型:Nullable<T>[DateTime]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

IStorageContext

出力

String

メモ

  • キーワード: 共通, Azure, サービス, データ, ストレージ, BLOB, キュー, テーブル