Remove-AzTag

  • Ссылка
Модуль:
Az.Resources

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

Синтаксис

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

RemovePredefinedTagSet: командлет Remove-AzTag удаляет предопределенные теги и значения Azure из подписки. Чтобы удалить определенные значения из предопределенного тега, используйте параметр Value . По умолчанию Remove-AzTag удаляет указанный тег и все его значения. Вы не можете удалить тег или значение, которое в настоящее время применяется к ресурсу или группе ресурсов. Перед использованием Remove-AzTag используйте параметр Tag командлета Set-AzResourceGroup для удаления тега или значений из группы ресурсов или ресурсов. Модуль тегов Azure, который Remove-AzTag является частью функции управления предопределенными тегами Azure. Тег Azure — это пара "имя-значение", которую можно использовать для классификации ресурсов и групп ресурсов Azure, таких как отдел или центр затрат, или отслеживание заметок или комментариев о ресурсах и группах. Вы можете определить и применить теги на одном шаге, но предопределенные теги позволяют устанавливать стандартные, согласованные, прогнозируемые имена и значения тегов в подписке.

RemoveByResourceIdParameterSet: командлет Remove-AzTag с resourceId удаляет весь набор тегов в ресурсе или подписке.

Примеры

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

Remove-AzTag -Name "Department"

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

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

Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru

Name:   Department
Count:  14
Values: 

        Name        Count
        =========   =====

        Finance        2
        IT            12

Эта команда удаляет значение HumanResources из предопределенного тега Отдела. Он не удаляет тег. Если значение было применено к любым ресурсам или группам ресурсов, команда завершается ошибкой.

Пример 3. Удаляет весь набор тегов в подписке

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Эта команда удаляет весь набор тегов в подписке с помощью {subId}. Он не вернет объект, удаленный, если не передается в "-PassThru".

Пример 4. Удаление всего набора тегов в ресурсе

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -PassThru

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

Эта команда удаляет весь набор тегов ресурса с помощью {resourceId}. Он возвращает удаленный oject при передаче в "-PassThru".

Параметры

-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

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

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

-PassThru

Возвращает объект, представляющий удаленный тег или полученный тег с удаленным значением.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

Type:String
Position:Named
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

String[]

SwitchParameter

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

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