次の方法で共有

New-AzureStorageFileSASToken

  • リファレンス
モジュール:
Azure.Storage

ストレージ ファイルの Shared Access Signature トークンを生成します。

警告

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

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

構文

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

説明

New-AzureStorageFileSASToken コマンドレットは、Azure Storage ファイルの Shared Access Signature トークンを生成します。

例

例 1: ファイルの完全なアクセス許可を持つ Shared Access Signature トークンを生成する

PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

このコマンドは、FilePath という名前のファイルに対する完全なアクセス許可を持つ Shared Access Signature トークンを生成します。

例 2: 制限時間がある Shared Access Signature トークンを生成する

PS C:\> $StartTime = Get-Date
PS C:\> $EndTime = $StartTime.AddHours(2.0)
PS C:\> New-AzureStorageFileSASToken -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-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

-File

CloudFile オブジェクトを指定します。 クラウド ファイルを作成することも、Get-AzureStorageFile コマンドレットを使用してクラウド ファイルを取得することもできます。

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

-ShareName

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

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

-StartTime

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

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

入力

String

CloudFile

IStorageContext

パラメーター: コンテキスト (ByValue)

出力

String