Condividi tramite

Remove-AzResourceGroup

  • Riferimento
Modulo:
Az.Resources

Rimuove un gruppo di risorse.

Sintassi

Remove-AzResourceGroup
      [-Name] <String>
      [-ForceDeletionType <String>]
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzResourceGroup
      -Id <String>
      [-ForceDeletionType <String>]
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-AzResourceGroup rimuove un gruppo di risorse di Azure e le relative risorse dalla sottoscrizione corrente. Per eliminare una risorsa, ma lasciare il gruppo di risorse, usare il cmdlet Remove-AzResource.

Esempio

Esempio 1: Rimuovere un gruppo di risorse

Remove-AzResourceGroup -Name "ContosoRG01"

Questo comando rimuove il gruppo di risorse ContosoRG01 dalla sottoscrizione. Il cmdlet richiede la conferma e non restituisce alcun output.

Esempio 2: Rimuovere un gruppo di risorse senza conferma

Get-AzResourceGroup -Name "ContosoRG01" | Remove-AzResourceGroup -Force

Questo comando usa il cmdlet Get-AzResourceGroup per ottenere il gruppo di risorse ContosoRG01 e quindi lo passa a Remove-AzResourceGroup usando l'operatore pipeline. Il parametro Force elimina la richiesta di conferma.

Esempio 3: Rimuovere tutti i gruppi di risorse

Get-AzResourceGroup | Remove-AzResourceGroup

Questo comando usa il cmdlet Get-AzResourceGroup per ottenere tutti i gruppi di risorse e quindi li passa a Remove-AzResourceGroup usando l'operatore pipeline.

Esempio 4: Rimuovere un gruppo di risorse usando ForceDeletionType

Remove-AzResourceGroup -Name "ContosoRG01" -ForceDeletionType "Microsoft.Compute/virtualMachineScaleSets,Microsoft.Compute/virtualMachines,Microsoft.Databricks/workspaces"

Questo comando rimuove il gruppo di risorse ContosoRG01 usando ForceDeletionType. Il cmdlet richiede la conferma e non restituisce alcun output.

Parametri

-ApiVersion

Specifica la versione dell'API supportata dal provider di risorse. È possibile specificare una versione diversa rispetto alla versione predefinita.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceDeletionType

Tipi di risorse da forzare l'eliminazione. Attualmente è supportato solo quanto segue: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica l'ID del gruppo di risorse da rimuovere. I caratteri jolly non sono consentiti.

Tipo:String
Alias:ResourceGroupId, ResourceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica i nomi dei gruppi di risorse da rimuovere. I caratteri jolly non sono consentiti.

Tipo:String
Alias:ResourceGroupName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

Boolean