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.