Export-AzResourceGroup
リソース グループをテンプレートとしてキャプチャし、ファイルに保存します。
構文
Export-AzResourceGroup
-ResourceGroupName <String>
[-Path <String>]
[-IncludeParameterDefaultValue]
[-IncludeComments]
[-SkipResourceNameParameterization]
[-SkipAllParameterization]
[-Resource <String[]>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Export-AzResourceGroup コマンドレットは、指定したリソース グループをテンプレートとしてキャプチャし、JSON ファイルに保存します。これは、リソース グループにリソースを既に作成し、テンプレートベースのデプロイを使用する利点を活用したい場合に役立ちます。 このコマンドレットを使用すると、リソース グループ内の既存のリソースのテンプレートを簡単に生成できます。 このコマンドレットがテンプレートの一部の生成に失敗する場合があります。 失敗したリソースが警告メッセージによって通知されます。 成功したパーツのテンプレートは引き続き生成されます。
例
例 1: リソース グループをエクスポートする
Export-AzResourceGroup -ResourceGroupName "TestGroup"
このコマンドは、TestGroup という名前のリソース グループをテンプレートとしてキャプチャし、現在のディレクトリの JSON ファイルに保存します。
例 2: リソース グループから 1 つのリソースをエクスポートする
Export-AzResourceGroup -ResourceGroupName "TestGroup" -Resource "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVirtualMachine"
このコマンドは、"TestGroup" リソース グループから "TestVirtualMachine" という名前の仮想マシン リソースをテンプレートとしてキャプチャし、現在のディレクトリの JSON ファイルに保存します。
例 3: リソース グループから選択したリソースをエクスポートする
Export-AzResourceGroup -ResourceGroupName "TestGroup" -SkipAllParameterization -Resource @(
"/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVm",
"/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Network/networkInterfaces/TestNic"
)
このコマンドは、"TestGroup" リソース グループから 2 つのリソースをテンプレートとしてキャプチャし、現在のディレクトリの JSON ファイルに保存します。 生成されたテンプレートには、生成されたパラメーターは含まれません。
パラメーター
-ApiVersion
使用するリソース プロバイダー API のバージョンを指定します。 指定しない場合は、最新の API バージョンが使用されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IncludeComments
この操作で、テンプレートをコメント付きでエクスポートすることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IncludeParameterDefaultValue
この操作によってテンプレート パラメーターが既定値と共にエクスポートされることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
テンプレート ファイルの出力パスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Pre
使用する API のバージョンを自動的に決定するときに、このコマンドレットがプレリリース API バージョンを使用することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Resource
結果をフィルター処理する resourceId の一覧。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
エクスポートするリソース グループの名前を指定します。
型: | String |
Aliases: | ResourceGroup |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SkipAllParameterization
すべてのパラメーター化をスキップします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkipResourceNameParameterization
リソース名のパラメーター化をスキップします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell