Get-AzTag

  • Referencia
Módulo:
Az.Resources

Obtiene etiquetas predefinidas de Azure | Obtiene todo el conjunto de etiquetas de un recurso o suscripción.

Syntax

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

Description

GetPredefinedTagSet: el cmdlet Get-AzTag 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 del que Get-AzTag forma parte 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-AzTag. Para aplicar una etiqueta predefinida a un grupo de recursos, use el parámetro Tag del cmdlet New-AzTag. Para buscar grupos de recursos para un nombre o nombre y valor de etiqueta específicos, use el parámetro Tag del cmdlet Get-AzResourceGroup.

GetByResourceIdParameterSet: el cmdlet Get-AzTag con un ResourceId obtiene todo el conjunto de etiquetas de un recurso o suscripción.

Ejemplos

Ejemplo 1: Obtener todas las etiquetas predefinidas

Get-AzTag

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

Get-AzTag -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

Get-AzTag -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.

Ejemplo 4: Obtención del conjunto completo de etiquetas en una suscripción

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Este comando obtiene todo el conjunto de etiquetas de la suscripción con {subId}.

Ejemplo 5: Obtención del conjunto completo de etiquetas en un recurso

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Este comando obtiene todo el conjunto de etiquetas del recurso con {resourceId}.

Parámetros

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

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

-Name

Nombre de la etiqueta predefinida. De forma predeterminada, Get-AzTag 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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Identificador de recurso de la entidad etiquetada. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

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

Entradas

String

SwitchParameter

Salidas

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource