Aracılığıyla paylaş

Update-AzTag

  • Başvuru
Modül:
Az.Resources

Bir kaynak veya abonelik üzerindeki etiket kümesini seçmeli olarak güncelleştirir.

Sözdizimi

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

Description

ResourceId içeren Update-AzTag cmdlet'i, bir kaynak veya abonelik üzerindeki etiket kümesini seçmeli olarak güncelleştirir. Bu işlem, belirtilen kaynakta veya abonelikte etiketlerin değiştirilmesine, birleştirilmesine veya seçmeli olarak silinmesine olanak tanır. Belirtilen varlığın işlemin sonunda en fazla 50 etiket olabilir. 'değiştir' seçeneği, mevcut etiketlerin tamamını yeni bir kümeyle değiştirir. 'Birleştir' seçeneği, yeni adlarla etiket eklemeye ve etiketlerin değerlerini mevcut adlarla güncelleştirmeye olanak tanır. 'Sil' seçeneği, belirli adlara veya ad/değer çiftlerine göre etiketlerin seçmeli olarak silinmesine olanak tanır.

Örnekler

Örnek 1: Abonelik üzerindeki etiket kümesini "Birleştirme" İşlemi ile seçmeli olarak güncelleştirir

$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

Bu komut abonelikte etiket kümesini "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx" ile birleştirir.

Örnek 2: Abonelik üzerindeki etiket kümesini "Değiştir" İşlemi ile seçmeli olarak güncelleştirir

$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

Bu komut abonelik üzerindeki etiket kümesini "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxx" ile değiştirir.

Örnek 3: Abonelik üzerindeki etiket kümesini "Sil" İşlemi ile seçmeli olarak güncelleştirir

$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

Bu komut abonelikte "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx" ile etiket kümesini siler.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Operation

Güncelleştirme işlemi. Seçenekler Birleştir, Değiştir ve Sil'dir.

Tür:TagPatchOperation
Kabul edilen değerler:Merge, Replace, Delete
Position:2
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceId

Etiketli varlığın kaynak tanımlayıcısı. Bir kaynak, kaynak grubu veya abonelik etiketlenebilir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tag

Güncelleştirme için kullanılacak etiket kümesi.

Tür:Hashtable
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

TagPatchOperation

Hashtable

Çıkışlar

PSTagResource