Get-AzResourceGroup

Módulo:
Az.Resources Module

Obtiene los grupos de recursos.

Sintaxis

GetByResourceGroupName (valor predeterminado) 

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

GetByResourceGroupId 

Get-AzResourceGroup
    [[-Location] <String>]
    [-Id <String>]
    [-ExpandProperties]
    [-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*

Ejemplo 7: Obtención de un grupo de recursos con propiedades expandidas

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExpandProperties

Cuando se especifica, la salida incluye CreatedTime y ChangedTime de un recurso.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ResourceGroupId, ResourceId

Conjuntos de parámetros

GetByResourceGroupId
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Location

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False
Alias:ResourceGroupName

Conjuntos de parámetros

GetByResourceGroupName
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Tag

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

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByResourceGroupName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Hashtable

Salidas

PSResourceGroup