Select-AzureSubscription
現在の Azure サブスクリプションと既定の Azure サブスクリプションを変更します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
SelectSubscriptionByNameParameterSet (既定)
Select-AzureSubscription
-SubscriptionName <String>
[-Account <String>]
[-Current]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
SelectDefaultSubscriptionByNameParameterSet
Select-AzureSubscription
-SubscriptionName <String>
[-Account <String>]
[-Default]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
SelectSubscriptionByIdParameterSet
Select-AzureSubscription
-SubscriptionId <String>
[-Account <String>]
[-Current]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
SelectDefaultSubscriptionByIdParameterSet
Select-AzureSubscription
-SubscriptionId <String>
[-Account <String>]
[-Default]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
NoCurrentSubscriptionParameterSet
Select-AzureSubscription
[-Account <String>]
[-NoCurrent]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
NoDefaultSubscriptionParameterSet
Select-AzureSubscription
[-Account <String>]
[-NoDefault]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
説明
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
例
例 1: 現在のサブスクリプションを設定する
C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering
このコマンドを実行すると、"ContosoEngineering" が現在のサブスクリプションになります。
例 2: 既定のサブスクリプションを設定する
C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"
このコマンドは、既定のサブスクリプションを "ContosoFinance" に変更します。既定のサブスクリプション データ ファイルではなく、Subscriptions.xml サブスクリプション データ ファイルに設定が保存されます。
パラメーター
-Account
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Current
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SelectSubscriptionByNameParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
SelectSubscriptionByIdParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Default
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SelectDefaultSubscriptionByNameParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
SelectDefaultSubscriptionByIdParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoCurrent
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NoCurrentSubscriptionParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoDefault
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NoDefaultSubscriptionParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PassThru
コマンドが成功した場合は$Trueを返し、失敗した場合は$Falseを返します。 既定では、このコマンドレットは出力を返しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
パラメーターのプロパティ
| 型: | AzureSMProfile |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SubscriptionId
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ID (アイディー) |
パラメーター セット
SelectSubscriptionByIdParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
SelectDefaultSubscriptionByIdParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SubscriptionName
Select-AzureSubscription コマンドレットは、現在の Azure サブスクリプションと既定の Azure サブスクリプションを設定およびクリアします。
"現在のサブスクリプション" は、現在の Windows PowerShell セッションで既定で使用されるサブスクリプションです。 "既定のサブスクリプション" は、すべての Windows PowerShell セッションで既定で使用されます。 "現在のサブスクリプション" ラベルを使用すると、他のすべてのセッションの "既定のサブスクリプション" を変更せずに、現在のセッションで既定で使用する別のサブスクリプションを指定できます。
"既定" のサブスクリプション指定は、サブスクリプション データ ファイルに保存されます。 セッション固有の "現在の" 指定は保存されません。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 名前 |
パラメーター セット
SelectSubscriptionByNameParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
SelectDefaultSubscriptionByNameParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
None
このコマンドレットへの入力はプロパティ名でパイプできますが、値によるパイプ処理は行いません。
出力
None or System.Boolean
PassThru パラメーターを使用すると、このコマンドレットはブール値を返します。 既定では、出力は生成されません。