Update-AzTag
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.
Tür: | SwitchParameter |
Aliases: | cf |
Position: | Named |
varsayılan değer: | False |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Tür: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | TagPatchOperation |
kabul edilen değerler: | Merge, Replace, Delete |
Position: | 2 |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | 0 |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Güncelleştirme için kullanılacak etiket kümesi.
Tür: | Hashtable |
Position: | 1 |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Aliases: | wi |
Position: | Named |
varsayılan değer: | False |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |