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

Remove-AzureRmTag

  • Ссылка
Модуль:
AzureRM.Tags

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

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

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

Примеры

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

PS C:\>Remove-AzureRmTag -Name "Department"

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

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

PS C:\>Remove-AzureRmTag -Name "Department" -Value "HumanResources" -PassThru
Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

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

Параметры

-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:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Указывает имя тега, который нужно удалить. По умолчанию Remove-AzureRmTag удаляет указанный тег и все его значения. Чтобы удалить выбранные значения, но не удалить тег, используйте параметр 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

-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

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

PSTag