Поделиться через


Remove-AzTag

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

Синтаксис

RemovePredefinedTagParameterSet

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

RemoveByResourceIdParameterSet

Remove-AzTag
    -ResourceId <String>
    [-PassThru]
    [-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}. Он возвращает удаленный объект при передаче в "-PassThru".

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemovePredefinedTagParameterSet
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PassThru

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemoveByResourceIdParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Value

Удаляет указанные значения из предопределенного тега, но не удаляет тег.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemovePredefinedTagParameterSet
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

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

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

String

String

SwitchParameter

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

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