Compartilhar via

Remove-AzTag

  • Referência
Módulo:
Az.Resources

Exclui marcas ou valores predefinidos do Azure | Exclui todo o conjunto de marcas em um recurso ou assinatura.

Sintaxe

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

Description

RemovePredefinedTagSet: o cmdlet Remove-AzTag exclui marcas e valores predefinidos do Azure de sua assinatura. Para excluir valores específicos de uma marca predefinida, use o parâmetro Value. Por padrão, Remove-AzTag exclui a marca especificada e todos os seus valores. Não é possível excluir uma marca ou valor que atualmente é aplicado a um recurso ou grupo de recursos. Antes de usar Remove-AzTag, use o parâmetro Marca do cmdlet Set-AzResourceGroup para excluir a marca ou os valores do recurso ou do grupo de recursos. O módulo Azure Tags do qual Remove-AzTag 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 custos, ou para acompanhar anotações ou comentários sobre os recursos e grupos. Você pode definir e aplicar marcas em uma única etapa, mas marcas predefinidas permitem estabelecer nomes e valores padrão, consistentes e previsíveis para as marcas em sua assinatura.

RemoveByResourceIdParameterSet: o cmdlet Remove-AzTag com um ResourceId exclui todo o conjunto de marcas em um recurso ou assinatura.

Exemplos

Exemplo 1: excluir uma marca predefinida

Remove-AzTag -Name "Department"

Esse comando exclui a marca predefinida denominada Departamento e todos os seus valores. Se a marca tiver sido aplicada a recursos ou grupos de recursos, o comando falhará.

Exemplo 2: excluir um valor de uma marca predefinida

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Esse comando exclui o valor HumanResources da marca de Departamento predefinida. Ele não exclui a marca. Se o valor tiver sido aplicado a recursos ou grupos de recursos, o comando falhará.

Exemplo 3: exclui todo o conjunto de marcas em uma assinatura

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

Esse comando exclui todo o conjunto de marcas na assinatura com {subId}. Ele não retornará o objeto excluído se não passar "-PassThru".

Exemplo 4: exclui todo o conjunto de marcas em um recurso

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

Esse comando exclui todo o conjunto de marcas no recurso com {resourceId}. Ele retorna o oject excluído ao passar "-PassThru".

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da marca predefinida a ser removida. Por padrão, Remove-AzTag remove a marca especificada e todos os seus valores. Para excluir valores selecionados, mas não excluir a marca, use o parâmetro Value.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceId

O identificador de recurso para a entidade marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Value

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

Tipo:String[]
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

String[]

SwitchParameter

Saídas

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