Compartir a través de

Get-AzureRmTag

  • Referencia
Módulo:
AzureRM.Tags

Obtiene etiquetas de Azure predefinidas.

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.

Sintaxis

Get-AzureRmTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureRmTag obtiene etiquetas de Azure predefinidas en la suscripción. Este cmdlet devuelve información básica sobre las etiquetas o información detallada sobre las etiquetas y sus valores. Todos los objetos de salida incluyen una propiedad Count que representa el número de recursos y grupos de recursos a los que se han aplicado las etiquetas y los valores. El módulo Etiquetas de Azure que Get-AzureRMTag forma parte de puede ayudarle a administrar etiquetas predefinidas de Azure. Una etiqueta de Azure es un par nombre-valor que puede usar para clasificar los recursos y grupos de recursos de Azure, como por departamento o centro de costos, o para realizar un seguimiento de notas o comentarios sobre los recursos y grupos. Puede definir y aplicar etiquetas en un solo paso, pero las etiquetas predefinidas permiten establecer nombres y valores estándar, coherentes y predecibles para las etiquetas de la suscripción. Para crear una etiqueta predefinida, use el cmdlet New-AzureRmTag. Para aplicar una etiqueta predefinida a un grupo de recursos, use el parámetro Tag del cmdlet New-AzureRmTag. Para buscar grupos de recursos para un nombre o valor de etiqueta específicos, use el parámetro Tag del cmdlet Get-AzureRMResourceGroup.

Ejemplos

Ejemplo 1: Obtener todas las etiquetas predefinidas

PS C:\>Get-AzureRmTag

Name      Count
========  =====

Department    5
FY2015        2
CostCenter   20

Este comando obtiene todas las etiquetas predefinidas de la suscripción. La propiedad Count muestra cuántas veces se ha aplicado la etiqueta a los recursos y grupos de recursos de la suscripción.

Ejemplo 2: Obtener una etiqueta por nombre

PS C:\>Get-AzureRmTag -Name "Department"

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3

Este comando obtiene información detallada sobre la etiqueta Department y sus valores. La propiedad Count muestra cuántas veces se ha aplicado la etiqueta y cada uno de sus valores a los recursos y grupos de recursos de la suscripción.

Ejemplo 3: Obtener valores de todas las etiquetas

PS C:\>Get-AzureRmTag -Detailed

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3


Name:   FY2015
Count:  2


Name:   CostCenter
Count:  20
Values: 

        Name        Count
        ==========  =====

        0001          5
        0002         10
        0003          5

Este comando usa el parámetro Detailed para obtener información detallada sobre todas las etiquetas predefinidas de la suscripción. El uso del parámetro Detailed es el equivalente de usar el parámetro Name para cada etiqueta.

Parámetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Detailed

Indica que esta operación agrega información sobre los valores de etiqueta a la salida.

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

-Name

Especifica el nombre de la etiqueta que se va a obtener. De forma predeterminada, Get-AzureRmTag obtiene información básica sobre todas las etiquetas predefinidas de la suscripción. Al especificar el parámetro Name , el parámetro Detailed no tiene ningún efecto.

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

Entradas

String

SwitchParameter

Salidas

PSTag