Share via

Remove-AzureRmTag

  • Referência
Módulo:
AzureRM.Tags

Exclui marcas ou valores predefinidos do Azure.

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Syntax

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

Description

O cmdlet Remove-AzureRmTag exclui marcas e valores predefinidos do Azure da sua assinatura. Para excluir valores específicos de uma tag predefinida, use o parâmetro Value . Por padrão, Remove-AzureRmTag exclui a tag especificada e todos os seus valores. Não é possível excluir uma marca ou um valor atualmente aplicado a um recurso ou grupo de recursos. Antes de usar Remove-AzureRmTag, use o parâmetro Tag do cmdlet Set-AzureRMResourceGroup para excluir a marca ou os valores do recurso ou grupo de recursos. O módulo Marcas do Azure do qual o Remove-AzureRmTag faz parte pode ajudá-lo a gerenciar suas marcas predefinidas do Azure. Uma marca do Azure é um par nome-valor que você pode usar para categorizar seus recursos e grupos de recursos do Azure, como por departamento ou centro de custo, ou para controlar anotações ou comentários sobre os recursos e grupos. Você pode definir e aplicar tags em uma única etapa, mas as tags predefinidas permitem estabelecer nomes e valores padrão, consistentes e previsíveis para as tags em sua assinatura.

Exemplos

Exemplo 1: Excluir uma tag predefinida

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

Este comando exclui a tag predefinida chamada Department e todos os seus recursos. Se a tag tiver sido aplicada a quaisquer recursos ou grupos de recursos, o comando falhará.

Exemplo 2: Excluir um valor de uma tag predefinida

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

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

        Finance        2
        IT            12

Este comando exclui o valor HumanResources da tag Department predefinida. Ele não exclui a tag. Se o valor tiver sido aplicado a quaisquer recursos ou grupos de recursos, o comando falhará.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

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

-Name

Especifica o nome da tag a ser excluída. Por padrão, Remove-AzureRmTag remove a tag especificada e todos os seus valores. Para excluir os valores selecionados, mas não excluir a tag , use o parâmetro Value .

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

-PassThru

Retorna um objeto que representa a tag excluída ou a tag resultante com valor excluído.

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

-Value

Exclui os valores especificados da tag predefinida, mas não exclui a tag.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

String

String[]

SwitchParameter

Saídas

PSTag