New-AzureStorageContext
Azure Storage コンテキストを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
-ConnectionString <String>
[<CommonParameters>] New-AzureStorageContext
[-Local]
[<CommonParameters>] 説明
New-AzureStorageContext コマンドレットは、Azure Storage コンテキストを作成します。
例
例 1: ストレージ アカウント名とキーを指定してコンテキストを作成する
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成します。
例 2: 接続文字列を指定してコンテキストを作成する
C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"このコマンドは、ContosoGeneral アカウントの指定した接続文字列に基づいてコンテキストを作成します。
例 3: 匿名ストレージ アカウントのコンテキストを作成する
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"このコマンドは、ContosoGeneral という名前のアカウントに対して匿名で使用するためのコンテキストを作成します。 このコマンドは、接続プロトコルとして HTTP を指定します。
例 4: ローカル開発ストレージ アカウントを使用してコンテキストを作成する
C:\PS>New-AzureStorageContext -Localこのコマンドは、ローカル開発ストレージ アカウントを使用してコンテキストを作成します。 このコマンドは、 Local パラメーターを指定します。
例 5: ローカル開発者ストレージ アカウントのコンテナーを取得する
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainerこのコマンドは、ローカル開発ストレージ アカウントを使用してコンテキストを作成し、パイプライン 演算子を使用して新しいコンテキストを Get-AzureStorageContainer コマンドレットに渡します。 このコマンドは、ローカル開発者ストレージ アカウントの Azure Storage コンテナーを取得します。
例 6: 複数のコンテナーを取得する
C:\PS>$Context01 = New-AzureStorageContext -Local
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer最初のコマンドは、ローカル開発ストレージ アカウントを使用してコンテキストを作成し、そのコンテキストを $Context 01 変数に格納します。 2 番目のコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成し、そのコンテキストを $Context 02 変数に格納します。 最後のコマンドは、 Get-AzureStorageContainer を使用して、$Context 01 および $Context 02 に格納されているコンテキストのコンテナーを取得します。
例 7: エンドポイントを使用してコンテキストを作成する
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"このコマンドは、指定されたストレージ エンドポイントを持つ Azure Storage コンテキストを作成します。 このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成します。
例 8: 指定した環境でコンテキストを作成する
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"このコマンドは、指定された Azure 環境を持つ Azure ストレージ コンテキストを作成します。 このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成します。
例 9: SAS トークンを使用してコンテキストを作成する
C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"最初のコマンドは、ContosoMain という名前のコンテナーの New-AzureStorageContainerSASToken コマンドレットを使用して SAS トークンを生成し、そのトークンを$SasToken変数に格納します。 このトークンは、読み取り、追加、更新、および削除のアクセス許可用です。 2 番目のコマンドは、$SasTokenに格納されている SAS トークンを使用する ContosoGeneral という名前のアカウントのコンテキストを作成し、そのコンテキストを$Context変数に格納します。 最後のコマンドは、$Contextに格納されているコンテキストを使用して、ContosoMain という名前のコンテナーに関連付けられているすべての BLOB を一覧表示します。
例 10: OAuth 認証を使用してコンテキストを作成する
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountこのコマンドは、OAuth 認証を使用してコンテキストを作成します。
パラメーター
-Anonymous
このコマンドレットによって、匿名ログオン用の Azure Storage コンテキストが作成されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ConnectionString
Azure Storage コンテキストの接続文字列を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Endpoint
Azure Storage コンテキストのエンドポイントを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Environment
Azure 環境を指定します。
このパラメーターに使用できる値は、AzureCloud と AzureChinaCloud です。
詳細を表示するには「Get-Help Get-AzureEnvironment」を入力します。
| 型: | String |
| Aliases: | Name, EnvironmentName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Local
このコマンドレットは、ローカル開発ストレージ アカウントを使用してコンテキストを作成することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Protocol
転送プロトコル (https/http)。
| 型: | String |
| 指定可能な値: | Http, Https |
| 配置: | 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 |
-UseConnectedAccount
このコマンドレットが OAuth 認証を使用して Azure Storage コンテキストを作成することを示します。 他の認証が指定されていない場合、コマンドレットは既定で OAuth 認証を使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |