New-AzStorageContext
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 コンテキストが作成されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Azure Storage BLOB サービス エンドポイント
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Azure Storage コンテキストの接続文字列を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableFileBackupRequestIntent
ファイルの OAuth (Microsoft Entra ID) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Azure Storage コンテキストのエンドポイントを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Environment
Azure 環境を指定します。
このパラメーターに使用できる値は、AzureCloud と AzureChinaCloud です。
詳細を表示するには「Get-Help Get-AzEnvironment」を入力します。
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Azure ストレージ ファイル サービス エンドポイント
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Local
このコマンドレットは、ローカル開発ストレージ アカウントを使用してコンテキストを作成することを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
転送プロトコル (https/http)。
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEndpoint
Azure Storage キュー サービス エンドポイント
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
コンテキストの Shared Access Signature (SAS) トークンを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountKey
Azure Storage アカウント キーを指定します。 このコマンドレットは、このパラメーターが指定するキーのコンテキストを作成します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountName
Azure Storage アカウント名を指定します。 このコマンドレットは、このパラメーターが指定するアカウントのコンテキストを作成します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableEndpoint
Azure Storage Table Service エンドポイント
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseConnectedAccount
このコマンドレットは、OAuth (Microsoft Entra ID) 認証を使用して Azure Storage コンテキストを作成することを示します。 他の認証が指定されていない場合、コマンドレットは既定で OAuth 認証を使用します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示