New-AzureStorageContext
Azure Storage コンテキストを作成します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
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
-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 "raud"
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 を一覧表示します。
パラメーター
-Anonymous
このコマンドレットによって、匿名ログオン用の Azure Storage コンテキストが作成されることを示します。
Type: | SwitchParameter |
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 |
-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-AzureEnvironment
」を入力します。
Type: | String |
Aliases: | Name, EnvironmentName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Local
このコマンドレットは、ローカル開発ストレージ アカウントを使用してコンテキストを作成することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
アカウント SAS で行われる要求に対して許可するプロトコルを指定します。 このパラメーターの有効値は、次のとおりです。
- HttpsOnly
- HttpsOrHttp
既定値は HttpsOrHttp です。
Type: | String |
Accepted values: | Http, Https |
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 |
出力
AzureStorageContext