Remove-AzureRmTag
Exclui marcas ou valores predefinidos do Azure.
Aviso
O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes 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 de sua assinatura. Para excluir valores específicos de uma marca predefinida, use o parâmetro Value . Por padrão, Remove-AzureRmTag exclui a marca especificada e todos os seus valores. Não é possível excluir uma marca ou valor que está 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 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 marca predefinida
PS C:\>Remove-AzureRmTag -Name "Department"
Esse comando exclui a marca predefinida chamada Department e todos os seus recursos. Se a marca 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
Esse comando exclui o valor HumanResources da marca 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 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 marca a ser excluída. Por padrão, Remove-AzureRmTag remove a marca especificada e todos os seus valores. Para excluir os valores selecionados, mas não excluir a marca, 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 marca excluída ou a marca 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 marca predefinida, mas não exclui a marca.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. 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[]