New-AzTag

Ссылка

Модуль:: Az.Resources

Создает предопределенный тег Azure или добавляет значения в существующий тег | Создает или обновляет весь набор тегов в ресурсе или подписке.

Синтаксис

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

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

Примеры

Пример 1. Создание предопределенного тега

New-AzTag -Name "FY2015"

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

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

Пример 2. Создание предопределенного тега со значением

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

Name:   Department
Count:  0
Values: 

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

Эта команда создает предопределенный тег с именем Department со значением Finance.

Пример 3. Добавление значения в предопределенный тег

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 добавляет значение в существующий тег вместо создания нового.

Пример 4. Использование предопределенного тега

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

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

Пример 5. Создание или обновление всего набора тегов в подписке

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

Пример 6. Создание или обновление всего набора тегов в ресурсе

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

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

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

-Name

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

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

-ResourceId

Идентификатор ресурса для сущности, помеченной тегом. Ресурс, группа ресурсов или подписка могут быть помечены.

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

-Tag

Теги, которые нужно поместить в ресурс.

Type:	Hashtable
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

Задает предопределенное значение тега. Предопределенные теги могут иметь несколько значений, но в каждой команде можно ввести только одно значение. Этот параметр является необязательным, так как теги могут иметь имена без значений.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

String

Hashtable

Выходные данные

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

New-AzTag

Синтаксис

Описание

Примеры

Пример 1. Создание предопределенного тега

Пример 2. Создание предопределенного тега со значением

Пример 3. Добавление значения в предопределенный тег

Пример 4. Использование предопределенного тега

Пример 5. Создание или обновление всего набора тегов в подписке

Пример 6. Создание или обновление всего набора тегов в ресурсе

Параметры

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Входные данные

Выходные данные

Обратная связь

Дополнительные ресурсы

New-AzTag

Синтаксис

Описание

Примеры

Пример 1. Создание предопределенного тега

Пример 2. Создание предопределенного тега со значением

Пример 3. Добавление значения в предопределенный тег

Пример 4. Использование предопределенного тега

Пример 5. Создание или обновление всего набора тегов в подписке

Пример 6. Создание или обновление всего набора тегов в ресурсе

Параметры

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Входные данные

Выходные данные

Связанные ссылки

Обратная связь

Дополнительные ресурсы