Export-AzResourceGroup

  • Referentie
Module:
Az.Resources

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

Syntax

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeComments

Geeft aan dat deze bewerking de sjabloon met opmerkingen exporteert.

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

-IncludeParameterDefaultValue

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

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

-Path

Hiermee geeft u het uitvoerpad van het sjabloonbestand.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Resource

Een lijst met resourceIds om de resultaten te filteren.

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

-ResourceGroupName

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

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

-SkipAllParameterization

Alle parameters overslaan.

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

-SkipResourceNameParameterization

Sla resourcenaamparameterisatie over.

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

-WhatIf

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

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

Invoerwaarden

String

Uitvoerwaarden

PSObject