Compartir a través de

Get-AzureRmResourceGroup

  • Referencia
Módulo:
AzureRM.Resources

Obtiene los grupos 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

Get-AzureRmResourceGroup
   [-Name <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResourceGroup
   [-Location <String>]
   [-Id <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureRmResourceGroup obtiene grupos de recursos de Azure en la suscripción actual. Puede obtener todos los grupos de recursos o especificar un grupo de recursos por nombre o por otras propiedades. De forma predeterminada, este cmdlet obtiene todos los grupos de recursos de la suscripción actual. Para más información sobre los recursos de Azure y los grupos de recursos de Azure, consulte el cmdlet New-AzureRmResourceGroup.

Ejemplos

Ejemplo 1: Obtención de un grupo de recursos por nombre

PS C:\>Get-AzureRmResourceGroup -Name "EngineerBlog"

Este comando obtiene el grupo de recursos de Azure en la suscripción denominada EngineerBlog.

Ejemplo 2: Obtención de todas las etiquetas de un grupo de recursos

PS C:\>(Get-AzureRmResourceGroup -Name "ContosoRG").Tags

Este comando obtiene el grupo de recursos denominado ContosoRG y muestra las etiquetas asociadas a ese grupo.

Ejemplo 3: Mostrar los grupos de recursos por ubicación

PS C:\> Get-AzureRmResourceGroup |
  Sort Location,ResourceGroupName |
  Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

Ejemplo 4: Mostrar los nombres de todos los grupos de recursos en una ubicación determinada

PS C:\> Get-AzureRmResourceGroup -Location westus2 |
   Sort ResourceGroupName | 
   Format-Wide ResourceGroupName -Column 4

Ejemplo 5: Mostrar los grupos de recursos cuyos nombres comienzan por WebServer

PS C:\> Get-AzureRmResourceGroup | Where ResourceGroupName -like WebServer*

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
Position:Named
valor predeterminado:None
Requerido: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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Tipo:String
Aliases:ResourceGroupId, ResourceId
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Especifica la ubicación del grupo de recursos que se va a obtener.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica el nombre del grupo de recursos que se va a obtener. Este parámetro admite caracteres comodín al principio o al final de la cadena.

Tipo:String
Aliases:ResourceGroupName
Position:Named
valor predeterminado:None
Requerido:False
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.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Etiqueta hashtable por la que se van a filtrar los grupos de recursos.

Tipo:Hashtable
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

None

Salidas

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup