Compartir a través de

Get-AzResourceGroup

  • Referencia
Módulo:
Az.Resources

Obtiene los grupos de recursos.

Sintaxis

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

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

(Get-AzResourceGroup -Name "ContosoRG").Tags

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

Ejemplo 3: Obtención de grupos de recursos en función de la etiqueta

Get-AzResourceGroup -Tag @{'environment'='prod'}

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

Get-AzResourceGroup |
  Sort-Object Location,ResourceGroupName |
    Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

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

Get-AzResourceGroup -Location westus2 |
  Sort-Object ResourceGroupName |
    Format-Wide ResourceGroupName -Column 4

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

Get-AzResourceGroup -Name 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
Posición:Named
Valor predeterminado:None
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

-Id

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

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

-Location

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

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Alias:ResourceGroupName
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-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

-Tag

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

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

Entradas

String

Hashtable

Salidas

PSResourceGroup