Delen via


Export-AzResourceGroup

Legt een resourcegroep vast als een sjabloon en slaat deze op in een bestand.

Syntaxis

Export-AzResourceGroup
      -ResourceGroupName <String>
      [-Path <String>]
      [-IncludeParameterDefaultValue]
      [-IncludeComments]
      [-SkipResourceNameParameterization]
      [-SkipAllParameterization]
      [-Resource <String[]>]
      [-Force]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De cmdlet Export-AzResourceGroup legt de opgegeven resourcegroep vast als sjabloon en slaat deze op in een JSON-bestand. Dit kan handig zijn in scenario's waarin u al enkele resources in uw resourcegroep hebt gemaakt en vervolgens gebruik wilt maken van de voordelen van het gebruik van door sjabloon ondersteunde implementaties. Met deze cmdlet kunt u eenvoudig beginnen met het genereren van de sjabloon voor uw bestaande resources in de resourcegroep. Er kunnen enkele gevallen zijn waarin deze cmdlet bepaalde onderdelen van de sjabloon niet kan genereren. Waarschuwingsberichten informeren u over de resources die zijn mislukt. De sjabloon wordt nog steeds gegenereerd voor de onderdelen die zijn geslaagd.

Voorbeelden

Voorbeeld 1: Een resourcegroep exporteren

Export-AzResourceGroup -ResourceGroupName "TestGroup"

Met deze opdracht wordt de resourcegroep met de naam TestGroup als sjabloon vastgelegd en opgeslagen in een JSON-bestand in de huidige map.

Voorbeeld 2: Één resource exporteren uit een resourcegroep

Export-AzResourceGroup -ResourceGroupName "TestGroup" -Resource "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVirtualMachine"

Met deze opdracht wordt de virtuele-machineresource met de naam TestVirtualMachine uit de resourcegroep TestGroup als sjabloon vastgelegd en opgeslagen in een JSON-bestand in de huidige map.

Voorbeeld 3: Een selectie van resources uit een resourcegroep exporteren

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"
)

Met deze opdracht worden twee resources uit de resourcegroep TestGroup als sjabloon vastgelegd en opgeslagen in een JSON-bestand in de huidige map. De gegenereerde sjabloon bevat geen gegenereerde parameters.

Parameters

-ApiVersion

Hiermee geeft u de versie van de resourceprovider-API die moet worden gebruikt. Als dit niet is opgegeven, wordt de meest recente API-versie gebruikt.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeComments

Geeft aan dat deze bewerking de sjabloon met opmerkingen exporteert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeParameterDefaultValue

Geeft aan dat met deze bewerking de sjabloonparameter met de standaardwaarde wordt geëxporteerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het uitvoerpad van het sjabloonbestand.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Pre

Geeft aan dat deze cmdlet api-versies van de voorlopige versie gebruikt wanneer automatisch wordt bepaald welke API-versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Resource

Een lijst met resourceIds om de resultaten te filteren.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep die moet worden geëxporteerd.

Type:String
Aliassen:ResourceGroup
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SkipAllParameterization

Alle parameters overslaan.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipResourceNameParameterization

Sla resourcenaamparameterisatie over.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

PSObject