Compartir a través de

Remove-AzTag

  • Referencia
Módulo:
Az.Resources

Elimina etiquetas o valores predefinidos de Azure | Elimina todo el conjunto de etiquetas de un recurso o suscripción.

Sintaxis

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

Description

RemovePredefinedTagSet: el cmdlet Remove-AzTag elimina las etiquetas y valores predefinidos de Azure de la suscripción. Para eliminar valores concretos de una etiqueta predefinida, use el parámetro Value . De forma predeterminada, Remove-AzTag elimina la etiqueta especificada y todos sus valores. No se puede eliminar una etiqueta o valor que se aplica actualmente a un recurso o grupo de recursos. Antes de usar Remove-AzTag, use el parámetro Tag del cmdlet Set-AzResourceGroup para eliminar la etiqueta o los valores del recurso o grupo de recursos. El módulo Etiquetas de Azure del que Remove-AzTag forma parte puede ayudarle a administrar las etiquetas predefinidas de Azure. Una etiqueta de Azure es un par nombre-valor que puede usar para clasificar los recursos y grupos de recursos de Azure, como por departamento o centro de costos, o para realizar un seguimiento de notas o comentarios sobre los recursos y grupos. Puede definir y aplicar etiquetas en un solo paso, pero las etiquetas predefinidas permiten establecer nombres y valores estándar, coherentes y predecibles para las etiquetas de la suscripción.

RemoveByResourceIdParameterSet: el cmdlet Remove-AzTag con un ResourceId elimina todo el conjunto de etiquetas de un recurso o suscripción.

Ejemplos

Ejemplo 1: Eliminar una etiqueta predefinida

Remove-AzTag -Name "Department"

Este comando elimina la etiqueta predefinida denominada Department y todos sus valores. Si la etiqueta se ha aplicado a cualquier recurso o grupo de recursos, se produce un error en el comando.

Ejemplo 2: Eliminar un valor de una etiqueta predefinida

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

Name:   Department
Count:  14
Values: 

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

        Finance        2
        IT            12

Este comando elimina el valor HumanResources de la etiqueta Department predefinida. No elimina la etiqueta. Si el valor se ha aplicado a cualquier recurso o grupo de recursos, se produce un error en el comando.

Ejemplo 3: Elimina todo el conjunto de etiquetas de una suscripción

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

Este comando elimina todo el conjunto de etiquetas de la suscripción con {subId}. No devolverá el objeto eliminado si no pasa "-PassThru".

Ejemplo 4: Elimina todo el conjunto de etiquetas de un 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 el conjunto de etiquetas del recurso con {resourceId}. Devuelve el oject eliminado al pasar "-PassThru".

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la etiqueta predefinida que se va a quitar. De forma predeterminada, Remove-AzTag quita la etiqueta especificada y todos sus valores. Para eliminar los valores seleccionados, pero no eliminar la etiqueta, use el parámetro Value .

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa la etiqueta eliminada o la etiqueta resultante con valores eliminados.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceId

Identificador de recurso de la entidad etiquetada. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Value

Elimina los valores especificados de la etiqueta predefinida, pero no elimina la etiqueta .

Tipo:String[]
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

String[]

SwitchParameter

Salidas

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