Export-AzResourceGroup
擷取資源群組作為範本,並將它儲存至檔案。
語法
Export-AzResourceGroup
-ResourceGroupName <String>
[-Path <String>]
[-IncludeParameterDefaultValue]
[-IncludeComments]
[-SkipResourceNameParameterization]
[-SkipAllParameterization]
[-Resource <String[]>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Export-AzResourceGroup Cmdlet 會將指定的資源群組擷取為範本,並將其儲存至 JSON 檔案。這在您已經在資源群組中建立一些資源,然後想要利用使用範本支援的部署的優點時,這非常有用。 此 Cmdlet 可讓您輕鬆開始為資源群組中的現有資源產生範本。 在某些情況下,此 Cmdlet 無法產生範本的某些部分。 警告訊息會通知您失敗的資源。 範本仍會針對成功的元件產生。
範例
範例 1:匯出資源群組
Export-AzResourceGroup -ResourceGroupName "TestGroup"
此命令會擷取名為TestGroup的資源群組作為範本,並將它儲存至目前目錄中的 JSON 檔案。
範例 2:從資源群組匯出單一資源
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」 資源群組擷取兩個資源作為範本,並將它儲存至目前目錄中的 JSON 檔案。 產生的範本不會包含任何產生的參數。
參數
-ApiVersion
指定要使用的資源提供者 API 版本。 如果未指定,則會使用最新的 API 版本。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
強制命令執行,而不要求使用者確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeComments
指出這項作業會導出具有批注的範本。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeParameterDefaultValue
表示此作業會導出具有預設值的樣板參數。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
指定範本檔案的輸出路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Pre
指出當自動判斷要使用的 API 版本時,此 Cmdlet 會使用發行前版本 API 版本。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Resource
要篩選結果的 resourceId 清單。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ResourceGroupName
指定要匯出的資源群組名稱。
類型: | String |
別名: | ResourceGroup |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-SkipAllParameterization
略過所有參數化。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SkipResourceNameParameterization
略過資源名稱參數化。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |