Update-AzTag

  • Başvuru
Modül:
Az.Resources

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

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Operation

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

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

TagPatchOperation

Hashtable

Çıkışlar

PSTagResource