Remove-AzureRmResourceGroup

Referencia

Módulo:: AzureRM.Resources

Elimina un grupo de recursos.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

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

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

Description

El cmdlet Remove-AzureRmResourceGroup 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-AzureRmResource.

Ejemplos

Ejemplo 1: Eliminación de un grupo de recursos

PS C:\>Remove-AzureRmResourceGroup -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

PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -Force

Este comando usa el cmdlet Get-AzureRmResourceGroup para obtener el grupo de recursos ContosoRG01 y, a continuación, lo pasa a Remove-AzureRmResourceGroup mediante el operador de canalización. El parámetro común Detallado obtiene información de estado sobre la operación y el parámetro Force suprime el mensaje de confirmación.

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

PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup

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

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.

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

-AsJob

Ejecución del cmdlet en segundo plano

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

-Confirm

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

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

-DefaultProfile

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

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

-Force

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

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

-Id

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

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

-Name

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

Type:	String
Aliases:	ResourceGroupName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-WhatIf

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

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