Share via

Menerapkan tag dengan Azure PowerShell

  • Artikel

Artikel ini menjelaskan cara menggunakan Azure PowerShell untuk menandai sumber daya, grup sumber daya, dan langganan. Untuk rekomendasi dan batasan tag, lihat Menggunakan tag untuk mengatur sumber daya Azure dan hierarki manajemen Anda.

Terapkan tag

Azure PowerShell menawarkan dua perintah untuk menerapkan tag: New-AzTag dan Update-AzTag. Anda harus memiliki modul Az.Resources versi 1.12.0 atau yang lebih baru. Anda dapat memeriksa versi milik anda dengan Get-InstalledModule -Name Az.Resources. Anda dapat memasang modul itu atau memasang Azure PowerShell versi 3.6.1 atau yang lebih baru.

New-AzTag menggantikan semua tag pada sumber daya, grup sumber daya, atau langganan. Saat Anda memanggil perintah, teruskan ID sumber daya entitas yang ingin Anda tandai.

Contoh berikut menerapkan sekumpulan tag ke akun penyimpanan:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

Ketika perintah selesai, perhatikan apakah sumber daya memiliki dua tag.

Properties :
        Name    Value
        ======  =======
        Dept    Finance
        Status  Normal

Jika Anda menjalankan perintah lagi tetapi kali ini dengan tag yang berbeda, perhatikan apakah tag sebelumnya menghilang.

$tags = @{"Team"="Compliance"; "Environment"="Production"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

Untuk menambahkan tag ke sumber daya yang sudah memiliki tag, gunakan Update-AzTag. Set -Operation parameter ke Merge.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Perhatikan bahwa tag yang ada tumbuh dengan penambahan dua tag baru.

Properties :
        Name         Value
        ===========  ==========
        Status       Normal
        Dept         Finance
        Team         Compliance
        Environment  Production

Setiap nama tag hanya dapat memiliki satu nilai. Jika Anda memberikan nilai baru untuk tag, nilai tersebut akan mengganti nilai lama meskipun Anda menggunakan operasi penggabungan. Contoh berikut mengubah Status tag dari Normal ke Hijau.

$tags = @{"Status"="Green"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

Ketika Anda mengatur parameter -Operation ke Replace, set tag yang baru akan menggantikan tag-tag yang ada.

$tags = @{"Project"="ECommerce"; "CostCenter"="00123"; "Team"="Web"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Replace

Hanya tag baru yang tersisa di sumber daya.

Properties :
        Name        Value
        ==========  =========
        CostCenter  00123
        Team        Web
        Project     ECommerce

Perintah yang sama juga berfungsi dengan grup sumber daya atau langganan. Teruskan pengidentifikasi untuk grup sumber daya atau langganan yang ingin Anda tandai.

Untuk menambahkan sekumpulan tag baru ke grup sumber daya, gunakan:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
New-AzTag -ResourceId $resourceGroup.ResourceId -tag $tags

Untuk perbarui tag untuk grup sumber daya, gunakan:

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

Untuk menambahkan sekumpulan tag baru ke langganan, gunakan:

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

Untuk perbarui tag untuk langganan, gunakan:

$tags = @{"Team"="Web Apps"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Update-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags -Operation Merge

Anda mungkin memiliki lebih dari satu sumber daya dengan nama yang sama dalam grup sumber daya. Dalam hal ini, Anda dapat mengatur setiap sumber daya dengan perintah berikut:

$resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName examplegroup
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

Daftar tag

Untuk mendapatkan tag bagi sumber daya, grup sumber daya, atau langganan, gunakan perintah Get-AzTag dan berikan ID sumber daya untuk entitas tersebut.

Untuk melihat tag untuk sumber daya, gunakan:

$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Get-AzTag -ResourceId $resource.id

Untuk melihat tag untuk grup sumber daya, gunakan:

$resourceGroup = Get-AzResourceGroup -Name demoGroup
Get-AzTag -ResourceId $resourceGroup.ResourceId

Untuk melihat tag untuk langganan, gunakan:

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Get-AzTag -ResourceId "/subscriptions/$subscription"

Daftar menurut tag

Untuk mendapatkan sumber daya yang memiliki nama dan nilai tag tertentu, gunakan:

(Get-AzResource -Tag @{ "CostCenter"="00123"}).Name

Untuk mendapatkan sumber daya yang memiliki nama dengan nilai tag tertentu, gunakan:

(Get-AzResource -TagName "Dept").Name

Untuk mendapatkan grup sumber daya yang memiliki nama dan nilai tag tertentu, gunakan:

(Get-AzResourceGroup -Tag @{ "CostCenter"="00123" }).ResourceGroupName

Hapus tag

Untuk menghapus tag tertentu, gunakan Update-AzTag dan set -Operation ke Delete Berikan ID sumber daya tag yang ingin Anda hapus.

$removeTags = @{"Project"="ECommerce"; "Team"="Web"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $removeTags -Operation Delete

Tag tertentu akan dihapus.

Properties :
        Name        Value
        ==========  =====
        CostCenter  00123

Untuk menghapus semua tag, gunakan perintah Remove-AzTag.

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Remove-AzTag -ResourceId "/subscriptions/$subscription"

Langkah berikutnya