Export-AzResourceGroup

擷取資源群組作為範本,並將它儲存至檔案。

Syntax

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 版本。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

強制命令執行,而不要求使用者確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeComments

指出這項作業會導出具有批注的範本。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeParameterDefaultValue

表示此作業會導出具有預設值的樣板參數。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

指定範本檔案的輸出路徑。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

指出當自動判斷要使用的 API 版本時,此 Cmdlet 會使用發行前版本 API 版本。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Resource

要篩選結果的 resourceId 清單。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

指定要匯出的資源群組名稱。

Type:String
Aliases:ResourceGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipAllParameterization

略過所有參數化。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipResourceNameParameterization

略過資源名稱參數化。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

輸出

PSObject