Remove-AzTag

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

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

RemovePredefinedTagSet: polecenie cmdlet Remove-AzTag usuwa wstępnie zdefiniowane tagi i wartości platformy Azure z subskrypcji. Aby usunąć określone wartości ze wstępnie zdefiniowanego tagu, użyj parametru Value . Domyślnie polecenie Remove-AzTag usuwa określony tag i wszystkie jego wartości. Nie można usunąć tagu lub wartości, która jest obecnie stosowana do zasobu lub grupy zasobów. Przed użyciem polecenia Remove-AzTag użyj parametru Tag polecenia cmdlet Set-AzResourceGroup, aby usunąć tag lub wartości z zasobu lub grupy zasobów. Moduł Azure Tags, który jest częścią narzędzia Remove-AzTag , może pomóc w zarządzaniu wstępnie zdefiniowanymi tagami platformy Azure. Tag platformy Azure to para nazwa-wartość, której można użyć do kategoryzowania zasobów i grup zasobów platformy Azure, takich jak dział lub centrum kosztów, albo do śledzenia notatek lub komentarzy dotyczących zasobów i grup. Tagi można definiować i stosować w jednym kroku, ale wstępnie zdefiniowane tagi umożliwiają ustanowienie standardowych, spójnych, przewidywalnych nazw i wartości tagów w ramach subskrypcji.

RemoveByResourceIdParameterSet: polecenie cmdlet Remove-AzTag z identyfikatorem ResourceId usuwa cały zestaw tagów w zasobie lub subskrypcji.

Remove-AzTag -Name "Department"

To polecenie usuwa wstępnie zdefiniowany tag o nazwie Dział i wszystkie jego wartości. Jeśli tag został zastosowany do dowolnych zasobów lub grup zasobów, polecenie zakończy się niepowodzeniem.

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

Name:   Department
Count:  14
Values:

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

        Finance        2
        IT            12

To polecenie usuwa wartość HumanResources ze wstępnie zdefiniowanego tagu Dział. Nie usuwa tagu. Jeśli wartość została zastosowana do dowolnych zasobów lub grup zasobów, polecenie zakończy się niepowodzeniem.

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

To polecenie usuwa cały zestaw tagów w subskrypcji z {subId}. Nie zwróci usuniętego obiektu, jeśli nie zostanie przekazany element "-PassThru".

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

To polecenie usuwa cały zestaw tagów w zasobie za pomocą identyfikatora {resourceId}. Zwraca on usunięty obiekt podczas przekazywania elementu "-PassThru".

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.