Udostępnij za pośrednictwem

Update-AzTag

  • Odwołanie
Moduł:
Az.Resources

Selektywnie aktualizuje zestaw tagów w zasobie lub subskrypcji.

Składnia

Update-AzTag
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Operation] <TagPatchOperation>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Update-AzTag z identyfikatorem ResourceId selektywnie aktualizuje zestaw tagów w zasobie lub subskrypcji. Ta operacja umożliwia zastępowanie, scalanie lub selektywne usuwanie tagów w określonym zasobie lub subskrypcji. Określona jednostka może mieć maksymalnie 50 tagów na końcu operacji. Opcja "replace" zastępuje cały zestaw istniejących tagów nowym zestawem. Opcja "scalanie" umożliwia dodawanie tagów z nowymi nazwami i aktualizowanie wartości tagów przy użyciu istniejących nazw. Opcja "usuń" umożliwia selektywne usuwanie tagów na podstawie podanych nazw lub par nazwa/wartość.

Przykłady

Przykład 1: Selektywne aktualizowanie zestawu tagów w subskrypcji za pomocą operacji "Scalanie"

$mergedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $mergedTags -Operation Merge

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key2     value2
             key3     value3

To polecenie scala zestaw tagów w subskrypcji z parametrem "xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx".

Przykład 2. Selektywne aktualizowanie zestawu tagów w subskrypcji za pomocą operacji "Replace"

$replacedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $replacedTags -Operation Replace

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key3     value3

To polecenie zastępuje zestaw tagów w subskrypcji ciągiem "xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx".

Przykład 3. Selektywne aktualizowanie zestawu tagów w subskrypcji za pomocą operacji "Usuń"

$deletedTags = @{"key1"="value1"}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $deletedTags -Operation Delete

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key3     value3

To polecenie usuwa zestaw tagów w subskrypcji za pomocą polecenia "xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx".

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

-Operation

Operacja aktualizacji. Opcje to Scalanie, Zastępowanie i Usuwanie.

Typ:TagPatchOperation
Dopuszczalne wartości:Merge, Replace, Delete
Position:2
Domyślna wartość:None
Wymagane:True
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:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Zestaw tagów do użycia do aktualizacji.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

TagPatchOperation

Hashtable

Dane wyjściowe

PSTagResource