Udostępnij za pośrednictwem

Remove-AzTag

  • Odwołanie
Moduł:
Az.Resources

Usuwa wstępnie zdefiniowane tagi lub wartości platformy Azure | Usuwa cały zestaw tagów w zasobie lub subskrypcji.

Składnia

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

Opis

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 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-AzTagużyj parametru tagu polecenia cmdlet Set-AzResourceGroup, aby usunąć tag lub wartości z zasobu lub grupy zasobów. Moduł Azure Tags, który 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 ResourceId usuwa cały zestaw tagów w zasobie lub subskrypcji.

Przykłady

Przykład 1. Usuwanie wstępnie zdefiniowanego tagu

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.

Przykład 2. Usuwanie wartości ze wstępnie zdefiniowanego tagu

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.

Przykład 3. Usuwa cały zestaw tagów w subskrypcji

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".

Przykład 4. Usuwa cały zestaw tagów w zasobie

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 usunięty element oject podczas przekazywania "-PassThru".

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę wstępnie zdefiniowanego tagu do usunięcia. Domyślnie Remove-AzTag usuwa określony tag i wszystkie jego wartości. Aby usunąć wybrane wartości, ale nie usunąć tagu, użyj parametru Value.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca obiekt reprezentujący usunięty tag lub wynikowy tag z wartością usuniętą.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceId

Identyfikator zasobu jednostki oznakowanej. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Value

Usuwa określone wartości ze wstępnie zdefiniowanego tagu, ale nie usuwa tagu.

Typ:String[]
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

String[]

SwitchParameter

Dane wyjściowe

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