Export-AzResourceGroup

  • Riferimento
Modulo:
Az.Resources

Acquisisce un gruppo di risorse come modello e lo salva in un file.

Sintassi

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

Descrizione

Il cmdlet Export-AzResourceGroup acquisisce il gruppo di risorse specificato come modello e lo salva in un file JSON. Ciò può essere utile negli scenari in cui sono già state create alcune risorse nel gruppo di risorse e quindi si vogliono sfruttare i vantaggi dell'uso delle distribuzioni basate su modelli. Questo cmdlet consente di iniziare facilmente generando il modello per le risorse esistenti nel gruppo di risorse. In alcuni casi questo cmdlet non riesce a generare alcune parti del modello. I messaggi di avviso informano le risorse che non sono riuscite. Il modello verrà comunque generato per le parti con esito positivo.

Esempio

Esempio 1: Esportare un gruppo di risorse

Export-AzResourceGroup -ResourceGroupName "TestGroup"

Questo comando acquisisce il gruppo di risorse denominato TestGroup come modello e lo salva in un file JSON nella directory corrente.

Esempio 2: Esportare una singola risorsa da un gruppo di risorse

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

Questo comando acquisisce la risorsa macchina virtuale denominata "TestVirtualMachine" dal gruppo di risorse "TestGroup" come modello e la salva in un file JSON nella directory corrente.

Esempio 3: Esportare una selezione di risorse da un gruppo di risorse

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

Questo comando acquisisce due risorse dal gruppo di risorse "TestGroup" come modello e lo salva in un file JSON nella directory corrente. Il modello generato non conterrà parametri generati.

Parametri

-ApiVersion

Specifica la versione dell'API del provider di risorse da usare. Se non specificato, viene usata la versione più recente dell'API.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-IncludeComments

Indica che questa operazione esporta il modello con commenti.

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

-IncludeParameterDefaultValue

Indica che questa operazione esporta il parametro del modello con il valore predefinito.

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

-Path

Specifica il percorso di output del file modello.

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

-Pre

Indica che questo cmdlet usa versioni API non definitive per determinare automaticamente la versione dell'API da usare.

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

-Resource

Elenco di resourceIds per filtrare i risultati.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse da esportare.

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

-SkipAllParameterization

Ignorare tutta la parametrizzazione.

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

-SkipResourceNameParameterization

Ignorare la parametrizzazione del nome della risorsa.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

Output

PSObject