Remove-AzTag
Exclui marcas ou valores predefinidos do Azure | Exclui todo o conjunto de marcas em um recurso ou assinatura.
Sintaxe
RemovePredefinedTagParameterSet
Remove-AzTag
[-Name] <String>
[[-Value] <String[]>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveByResourceIdParameterSet
Remove-AzTag
-ResourceId <String>
[-PassThru]
[-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 Tag do cmdlet Set-AzResourceGroup para excluir a marca ou os valores do recurso ou grupo de recursos. O módulo de Marcas do Azure do qual o 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 objeto excluído ao passar "-PassThru".
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades do parâmetro
| Tipo: | IAzureContextContainer |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 Valor .
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RemovePredefinedTagParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PassThru
Retorna um objeto que representa a marca excluída ou a marca resultante com valor excluído.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResourceId
O identificador de recurso para a entidade marcada. Um recurso, um grupo de recursos ou uma assinatura podem ser marcados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RemoveByResourceIdParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Value
Exclui os valores especificados da marca predefinida, mas não exclui a marca.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RemovePredefinedTagParameterSet
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
