Get-AzTag

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

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

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.

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.

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.

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.

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}.

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}.

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.