Remove-AzResourceGroup

  • Riferimento
Modulo:
Az.Resources

Rimuove un gruppo di risorse.

Sintassi

Remove-AzResourceGroup
      [-Name] <String>
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzResourceGroup
      -Id <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.

Parametri

-ApiVersion

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

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

-AsJob

Eseguire il cmdlet in background

Type:SwitchParameter
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

-Id

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

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

-Name

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

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

-Pre

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

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

Boolean