Compartir a través de

New-AzTag

  • Referencia
Módulo:
Az.Resources

Crea una etiqueta de Azure predefinida o agrega valores a una etiqueta existente | Crea o actualiza todo el conjunto de etiquetas en un recurso o suscripción.

Sintaxis

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

Description

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.

Ejemplos

Ejemplo 1: Crear una etiqueta predefinida

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.

Ejemplo 2: Creación de una etiqueta predefinida con un valor

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.

Ejemplo 3: Agregar un valor a una etiqueta predefinida

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.

Ejemplo 4: Usar una etiqueta predefinida

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.

Ejemplo 5: Crea o actualiza todo el conjunto de etiquetas de una suscripción

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

Ejemplo 6: Crea o actualiza todo el conjunto de etiquetas en un recurso

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

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DefaultProfile

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

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

-Name

Especifica el nombre de etiqueta predefinido. Para crear una nueva etiqueta predefinida, escriba un nombre único. Para agregar un valor a una etiqueta existente, escriba el nombre de la etiqueta existente. Si una etiqueta predefinida existente tiene el nombre especificado, New-AzTag agrega el valor especificado, si existe, a la etiqueta con ese nombre en lugar de crear una nueva etiqueta.

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

-ResourceId

Identificador de recurso de la entidad que se va a etiquetar. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

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

-Tag

Etiquetas que se van a colocar en el recurso.

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

-Value

Especifica un valor de etiqueta predefinido. Las etiquetas predefinidas pueden tener varios valores, pero solo puede especificar un valor en cada comando. Este parámetro es opcional, ya que las etiquetas pueden tener nombres sin valores.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

String

Hashtable

Salidas

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