Share via

Get-AzResourceGroup

  • Referencia
Módulo:
Az.Resources

Obtiene los grupos de recursos.

Syntax

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

Description

El cmdlet Get-AzResourceGroup 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-AzResourceGroup.

Ejemplos

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

PS C:\>Get-AzResourceGroup -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-AzResourceGroup -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-AzResourceGroup |
  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-AzResourceGroup -Location westus2 |
   Sort ResourceGroupName |
   Format-Wide ResourceGroupName -Column 4

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

PS C:\> Get-AzResourceGroup | 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.

Type:String
Position:Named
Default value:None
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:AzContext, AzureCredential
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 obtener. No se admite el uso de caracteres comodín.

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

-Location

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

Type:String
Position:Named
Default value:None
Required: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.

Type:String
Aliases:ResourceGroupName
Position:Named
Default value:None
Required: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.

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

-Tag

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

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

Entradas

None

Salidas

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup