Remove-AzTag

Referência

Módulo:: Az.Resources

Elimina tags ou valores Azure predefinidos | Elimina todo o conjunto de tags num recurso ou subscrição.

Syntax

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

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

Description

Remover O Objetivo de Identificação: O cmdlet Remove-AzTag elimina tags e valores Azure predefinidos da sua subscrição. Para eliminar valores específicos de uma etiqueta predefinida, utilize o parâmetro Valor . Por predefinição, remove-AzTag elimina a etiqueta especificada e todos os seus valores. Não é possível eliminar uma etiqueta ou valor que é atualmente aplicado a um grupo de recursos ou recursos. Antes de utilizar o Remove-AzTag, utilize o parâmetro tag do Set-AzResourceGroup cmdlet para eliminar a etiqueta ou valores do grupo de recursos ou recursos. O módulo Azure Tags de que remove-AzTag pode ajudá-lo a gerir as suas tags Azure pré-definidas. Uma etiqueta Azure é um par de valor-nome que você pode usar para categorizar seus recursos E grupos de recursos Azure, como por departamento ou centro de custos, ou para rastrear notas ou comentários sobre os recursos e grupos. Pode definir e aplicar tags num único passo, mas as tags predefinidas permitem-lhe estabelecer nomes e valores padrão, consistentes e previsíveis para as tags na sua subscrição.

RemoveByResourceIdParameterSet: O cmdlet Remove-AzTag com um ResourceId elimina todo o conjunto de tags num recurso ou subscrição.

Exemplos

Exemplo 1: Eliminar uma etiqueta predefinida

Remove-AzTag -Name "Department"

Este comando elimina a etiqueta predefinida nomeada Departamento e todos os seus valores. Se a etiqueta tiver sido aplicada a quaisquer recursos ou grupos de recursos, o comando falha.

Exemplo 2: Eliminar um valor de uma etiqueta predefinida

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Este comando elimina o valor humanResources da etiqueta do Departamento predefinido. Não apaga a etiqueta. Se o valor tiver sido aplicado a quaisquer recursos ou grupos de recursos, o comando falha.

Exemplo 3: Elimina todo o conjunto de tags numa subscrição

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

Este comando elimina todo o conjunto de tags na subscrição com {subId}. Não devolverá o objeto apagado se não passar em "-PassThru".

Exemplo 4: Elimina todo o conjunto de tags num 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

Este comando elimina todo o conjunto de tags no recurso com {resourceId}. Devolve o ojecto apagado ao passar em "-PassThru".

Parâmetros

-Confirm

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

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

-DefaultProfile

As credenciais, conta, inquilino e subscrição utilizadas para comunicação com azul.

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

-Name

Especifica o nome da etiqueta predefinida para remover. Por predefinição, remove o Remove-AzTag remove a etiqueta especificada e todos os seus valores. Para eliminar valores selecionados, mas não eliminar a etiqueta, utilize o parâmetro Valor .

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

-PassThru

Devolve um objeto que representa a etiqueta eliminada ou a etiqueta resultante com valor apagado.

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

-ResourceId

O identificador de recursos para a entidade marcada. Um recurso, um grupo de recursos ou uma subscrição podem ser marcados.

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

-Value

Elimina os valores especificados da etiqueta predefinida, mas não apaga a etiqueta.

Type:	String[]
Position:	1
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

String[]

SwitchParameter

Saídas

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