New-AzStorageContext

モジュール:

Az.Storage

Azure Storage コンテキストを作成します。

構文

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   -BlobEndpoint <String>
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   -SasToken <String>
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]

New-AzStorageContext
   [-Local]
   [<CommonParameters>]

New-AzStorageContext
   [-Anonymous]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-UseConnectedAccount]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

説明

New-AzStorageContext コマンドレットは、Azure Storage コンテキストを作成します。 ストレージ コンテキストの既定の認証は、ストレージ アカウント名のみを入力する場合、OAuth (Microsoft Entra ID) です。 https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-servicesのストレージ サービスの認証の詳細を参照してください。

例

例 1: ストレージ アカウント名とキーを指定してコンテキストを作成する

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成します。

例 2: 接続文字列を指定してコンテキストを作成する

New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

このコマンドは、ContosoGeneral アカウントの指定した接続文字列に基づいてコンテキストを作成します。

例 3: 匿名ストレージ アカウントのコンテキストを作成する

New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

このコマンドは、ContosoGeneral という名前のアカウントに対して匿名で使用するためのコンテキストを作成します。 このコマンドは、接続プロトコルとして HTTP を指定します。

例 4: ローカル開発ストレージ アカウントを使用してコンテキストを作成する

New-AzStorageContext -Local

このコマンドは、ローカル開発ストレージ アカウントを使用してコンテキストを作成します。 このコマンドは、 Local パラメーターを指定します。

例 5: ローカル開発者ストレージ アカウントのコンテナーを取得する

New-AzStorageContext -Local | Get-AzStorageContainer

このコマンドは、ローカル開発ストレージ アカウントを使用してコンテキストを作成し、パイプライン 演算子を使用して新しいコンテキストを Get-AzStorageContainer コマンドレットに渡します。 このコマンドは、ローカル開発者ストレージ アカウントの Azure Storage コンテナーを取得します。

例 6: 複数のコンテナーを取得する

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

最初のコマンドは、ローカル開発ストレージ アカウントを使用してコンテキストを作成し、そのコンテキストを $Context 01 変数に格納します。 2 番目のコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成し、そのコンテキストを $Context 02 変数に格納します。 最後のコマンドは、 Get-AzStorageContainer を使用して、$Context 01 および $Context 02 に格納されているコンテキストのコンテナーを取得します。

例 7: エンドポイントを使用してコンテキストを作成する

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

このコマンドは、指定されたストレージ エンドポイントを持つ Azure Storage コンテキストを作成します。 このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成します。

例 8: 指定した環境でコンテキストを作成する

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

このコマンドは、指定された Azure 環境を持つ Azure ストレージ コンテキストを作成します。 このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成します。

例 9: SAS トークンを使用してコンテキストを作成する

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

最初のコマンドは、ContosoMain という名前のコンテナーの New-AzStorageContainerSASToken コマンドレットを使用して SAS トークンを生成し、そのトークンを$SasToken変数に格納します。 このトークンは、読み取り、追加、更新、および削除のアクセス許可用です。 2 番目のコマンドは、$SasTokenに格納されている SAS トークンを使用する ContosoGeneral という名前のアカウントのコンテキストを作成し、そのコンテキストを$Context変数に格納します。 最後のコマンドは、$Contextに格納されているコンテキストを使用して、ContosoMain という名前のコンテナーに関連付けられているすべての BLOB を一覧表示します。

例 10: OAuth 認証を使用してコンテキストを作成する

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

このコマンドは、OAuth (Microsoft Entra ID) 認証を使用してコンテキストを作成します。

例 11: ストレージ アカウント名、ストレージ アカウント キー、およびカスタム BLOB エンドポイントを指定してコンテキストを作成する

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

このコマンドは、アカウントのキーと指定された BLOB エンドポイントを使用して、myaccountname という名前のアカウントのコンテキストを作成します。

例 12: 指定された BLOB エンドポイントを持つ匿名ストレージ アカウントのコンテキストを作成する

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

このコマンドは、指定された BLOB エンポイントを使用して、myaccountname という名前のアカウントに対して匿名で使用するためのコンテキストを作成します。

例 13: 指定されたエンドポイントで SAS トークンを使用してコンテキストを作成する

$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
New-AzStorageContext -SasToken $SasToken -BlobEndpoint "https://myaccountname.blob.core.windows.net/" -TableEndpoint "https://myaccountname.table.core.windows.net/" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"

最初のコマンドは、MyContainer という名前のコンテナーの New-AzStorageContainerSASToken コマンドレットを使用して SAS トークンを生成し、そのトークンを$SasToken変数に格納します。 2 番目のコマンドは、SAS トークンと、指定された BLOB エンドポイント、テーブル エンドポイント、ファイル エンドポイント、キュー エンドポイントを使用するコンテキストを作成します。

例 14: 指定された BLOB エンドポイントで OAuth 認証を使用してコンテキストを作成する

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

このコマンドは、指定された BLOB エンドポイントで OAuth 認証を使用してコンテキストを作成します。

例 15: ファイル サービスで OAuth 認証を使用してコンテキストを作成する

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

このコマンドは、File サービスで OAuth (Microsoft Entra ID) 認証を使用するコンテキストを作成します。 ファイル サービスに OAuth (Microsoft Entra ID) 認証を使用するには、パラメーター '-EnableFileBackupRequestIntent' が必要です。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

パラメーター

-Anonymous

このコマンドレットによって、匿名ログオン用の Azure Storage コンテキストが作成されることを示します。

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

-BlobEndpoint

Azure Storage BLOB サービス エンドポイント

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

-ConnectionString

Azure Storage コンテキストの接続文字列を指定します。

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

-EnableFileBackupRequestIntent

ファイルの OAuth (Microsoft Entra ID) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

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

-Endpoint

Azure Storage コンテキストのエンドポイントを指定します。

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

-Environment

Azure 環境を指定します。 このパラメーターに使用できる値は、AzureCloud と AzureChinaCloud です。 詳細を表示するには「Get-Help Get-AzEnvironment」を入力します。

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

-FileEndpoint

Azure ストレージ ファイル サービス エンドポイント

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

-Local

このコマンドレットは、ローカル開発ストレージ アカウントを使用してコンテキストを作成することを示します。

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

-Protocol

転送プロトコル (https/http)。

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

-QueueEndpoint

Azure Storage キュー サービス エンドポイント

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

-SasToken

コンテキストの Shared Access Signature (SAS) トークンを指定します。

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

-StorageAccountKey

Azure Storage アカウント キーを指定します。 このコマンドレットは、このパラメーターが指定するキーのコンテキストを作成します。

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

-StorageAccountName

Azure Storage アカウント名を指定します。 このコマンドレットは、このパラメーターが指定するアカウントのコンテキストを作成します。

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

-TableEndpoint

Azure Storage Table Service エンドポイント

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

-UseConnectedAccount

このコマンドレットは、OAuth (Microsoft Entra ID) 認証を使用して Azure Storage コンテキストを作成することを示します。 他の認証が指定されていない場合、コマンドレットは既定で OAuth 認証を使用します。

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

入力

String

出力

AzureStorageContext

関連リンク

• Get-AzStorageBlob
• New-AzStorageContainerSASToken