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: командлет New-AzTag создает предопределенный тег Azure с необязательным предопределенным значением. Вы также можете использовать его для добавления дополнительных значений в существующие предопределенные теги. Чтобы создать предопределенный тег, введите уникальное имя тега. Чтобы добавить значение в существующий предопределенный тег, укажите имя существующего тега и новое значение. Этот командлет возвращает объект, представляющий новый или измененный тег со своими значениями и количеством ресурсов, к которым он был применен. Модуль тегов Azure, в который входит New-AzTag , поможет вам управлять предопределенными тегами Azure. Тег Azure — это пара "имя-значение", которую можно использовать для классификации ресурсов и групп ресурсов Azure, таких как отдел или центр затрат, или отслеживание заметок или комментариев о ресурсах и группах. Вы можете определить и применить теги на одном шаге, но предопределенные теги позволяют устанавливать стандартные, согласованные, прогнозируемые имена и значения тегов в подписке. Чтобы применить предопределенный тег к ресурсу или группе ресурсов, используйте параметр Тега командлета New-AzTag. Чтобы найти группы ресурсов с указанным именем тега или именем и значением, используйте параметр Тега командлета Get-AzResourceGroup. У каждого тега есть имя. Значения являются необязательными. Предопределенный тег Azure может иметь несколько значений, но при применении тега к ресурсу или группе ресурсов применяется имя тега и только одно из его значений. Например, можно создать предопределенный тег отдела со значением для каждого отдела, например финансов, кадров и ИТ-отдела. При применении тега Отдела к ресурсу применяется только одно предопределенное значение, например Finance.

CreateByResourceIdParameterSet: командлет New-AzTag с resourceId создает или обновляет весь набор тегов в ресурсе или подписке. Эта операция позволяет добавлять или заменять весь набор тегов в указанном ресурсе или подписке. Указанная сущность может содержать не более 50 тегов.

New-AzTag -Name "FY2015"

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

Эта команда создает предопределенный тег с именем FY2015. Этот тег не имеет значений. Вы можете применить тег без значений к ресурсу или группе ресурсов или использовать New-AzTag для добавления значений в тег. Можно также указать значение при применении тега к ресурсу или группе ресурсов.

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

Name:   Department
Count:  0
Values:

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

Эта команда создает предопределенный тег с именем Department со значением 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

Эти команды создают предопределенный тег с именем Department с двумя значениями. Если имя тега существует, New-AzTag добавляет значение в существующий тег вместо создания нового.

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

Команды в этом примере создают и используют предопределенный тег.

$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

Эта команда создает или обновляет весь набор тегов в подписке с помощью {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

Эта команда создает или обновляет весь набор тегов ресурса с помощью {resourceId}.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.