New-AzTag

New-AzTag
    [-Name] <String>
    [[-Value] <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzTag
    [-ResourceId] <String>
    [-Tag] <Hashtable>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreatePredefinedTagSet: el cmdlet New-AzTag crea una etiqueta de Azure predefinida con un valor predefinido opcional. También puede usarlo para agregar valores adicionales a las etiquetas predefinidas existentes. Para crear una etiqueta predefinida, escriba un nombre de etiqueta único. Para agregar un valor a una etiqueta predefinida existente, especifique el nombre de la etiqueta existente y el nuevo valor. Este cmdlet devuelve un objeto que representa la etiqueta nueva o modificada con sus valores y el número de recursos a los que se ha aplicado. El módulo Etiquetas de Azure del que New-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 aplicar una etiqueta predefinida a un recurso o grupo de recursos, use el parámetro Tag del cmdlet New-AzTag. Para buscar grupos de recursos con un nombre de etiqueta o un nombre y un valor especificados, use el parámetro Tag del cmdlet Get-AzResourceGroup. Cada etiqueta tiene un nombre. Los valores son opcionales. Una etiqueta de Azure predefinida puede tener varios valores, pero cuando se aplica la etiqueta a un recurso o grupo de recursos, se aplica el nombre de etiqueta y solo uno de sus valores. Por ejemplo, puede crear una etiqueta department predefinida con un valor para cada departamento, como Finanzas, Recursos humanos y TI. Al aplicar la etiqueta Department a un recurso, solo se aplica un valor predefinido, como Finance.

CreateByResourceIdParameterSet: el cmdlet New-AzTag con un ResourceId crea o actualiza todo el conjunto de etiquetas de un recurso o suscripción. Esta operación permite agregar o reemplazar todo el conjunto de etiquetas en el recurso o la suscripción especificados. La entidad especificada puede tener un máximo de 50 etiquetas.

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values
----   ----------- ----- ------
FY2015             0     {}

Este comando crea una etiqueta predefinida denominada FY2015. Esta etiqueta no tiene valores. Puede aplicar una etiqueta sin valores a un recurso o grupo de recursos, o usar New-AzTag para agregar valores a la etiqueta. También puede especificar un valor al aplicar la etiqueta al recurso o al grupo de recursos.

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values:

        Name        Count
        =========   =====
        Finance     0

Este comando crea una etiqueta predefinida denominada Department con un valor de Finance.

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values:
        Name        Count
        =========   =====
        Finance     0
New-AzTag -Name "Department" -Value "IT"
Name:   Department
Count:  0
Values:
        Name        Count
        =========   =====
        Finance     0
        IT          0

Estos comandos crean una etiqueta predefinida denominada Department con dos valores. Si el nombre de etiqueta existe, New-AzTag agrega el valor a la etiqueta existente en lugar de crear uno nuevo.

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values:
        Name        Count
        =========   =====
        0001        0

Set-AzResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}

Name:      EngineerBlog
Location:  East US
Resources:

  Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US
    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags:
    Name         Value
    ==========   =====
    CostCenter   0001

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values:
        Name        Count
        =========   =====
        0001        1

Get-AzResourceGroup -Tag @{Name="CostCenter"}

Name:      EngineerBlog
Location:  East US
Resources:
     Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US

    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags:
    Name         Value
    ==========   =====
    CostCenter   0001

Los comandos de este ejemplo crean y usan una etiqueta predefinida.

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

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

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

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

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

Este comando crea o actualiza 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.