Compartir a través de

Remove-AzResourceGroup

  • Referencia
Módulo:
Az.Resources

Elimina un grupo de recursos.

Sintaxis

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>]

Description

El cmdlet Remove-AzResourceGroup quita un grupo de recursos de Azure y sus recursos de la suscripción actual. Para eliminar un recurso, pero deje el grupo de recursos, use el cmdlet Remove-AzResource.

Ejemplos

Ejemplo 1: Eliminación de un grupo de recursos

Remove-AzResourceGroup -Name "ContosoRG01"

Este comando quita el grupo de recursos ContosoRG01 de la suscripción. El cmdlet le pide confirmación y no devuelve ninguna salida.

Ejemplo 2: Eliminación de un grupo de recursos sin confirmación

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

Este comando usa el cmdlet Get-AzResourceGroup para obtener el grupo de recursos ContosoRG01 y, a continuación, lo pasa a Remove-AzResourceGroup mediante el operador de canalización. El parámetro Force suprime el mensaje de confirmación.

Ejemplo 3: Eliminación de todos los grupos de recursos

Get-AzResourceGroup | Remove-AzResourceGroup

Este comando usa el cmdlet Get-AzResourceGroup para obtener todos los grupos de recursos y, a continuación, los pasa a Remove-AzResourceGroup mediante el operador de canalización.

Ejemplo 4: Eliminación de grupos de recursos mediante ForceDeletionType

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

Este comando quita el grupo de recursos ContosoRG01 mediante ForceDeletionType. El cmdlet le pide confirmación y no devuelve ninguna salida.

Parámetros

-ApiVersion

Especifica la versión de API compatible con el proveedor de recursos. Puede especificar una versión diferente de la versión predeterminada.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceDeletionType

Los tipos de recursos que desea forzar la eliminación. Actualmente, solo se admite lo siguiente: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica el identificador del grupo de recursos que se va a quitar. No se admite el uso de caracteres comodín.

Tipo:String
Alias:ResourceGroupId, ResourceId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica los nombres de los grupos de recursos que se van a quitar. No se admite el uso de caracteres comodín.

Tipo:String
Alias:ResourceGroupName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Pre

Indica que este cmdlet considera las versiones de API de versión preliminar cuando determina automáticamente qué versión se va a usar.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Salidas

Boolean