Bagikan melalui

Get-AzureRmTag

  • Referensi
Modul:
AzureRM.Tags

Mendapatkan tag Azure yang telah ditentukan sebelumnya.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

Get-AzureRmTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzureRmTag mendapatkan tag Azure yang telah ditentukan sebelumnya dalam langganan Anda. Cmdlet ini mengembalikan informasi dasar tentang tag atau informasi terperinci tentang tag dan nilainya. Semua objek output menyertakan properti Hitung yang mewakili jumlah sumber daya dan grup sumber daya tempat tag dan nilai telah diterapkan. Modul Tag Azure yang get-AzureRMTag adalah bagian dari dapat membantu Anda mengelola tag Azure yang telah ditentukan sebelumnya. Tag Azure adalah pasangan nama-nilai yang dapat Anda gunakan untuk mengategorikan sumber daya Azure dan grup sumber daya Anda, seperti berdasarkan departemen atau pusat biaya, atau untuk melacak catatan atau komentar tentang sumber daya dan grup. Anda dapat menentukan dan menerapkan tag dalam satu langkah, tetapi tag yang telah ditentukan memungkinkan Anda menetapkan nama dan nilai standar, konsisten, dan dapat diprediksi untuk tag dalam langganan Anda. Untuk membuat tag yang telah ditentukan sebelumnya, gunakan cmdlet New-AzureRmTag. Untuk menerapkan tag yang telah ditentukan sebelumnya ke grup sumber daya, gunakan parameter Tag cmdlet New-AzureRmTag. Untuk mencari grup sumber daya untuk nama atau nilai tag tertentu, gunakan parameter Tag cmdlet Get-AzureRMResourceGroup.

Contoh

Contoh 1: Mendapatkan semua tag yang telah ditentukan sebelumnya

PS C:\>Get-AzureRmTag

Name      Count
========  =====

Department    5
FY2015        2
CostCenter   20

Perintah ini mendapatkan semua tag yang telah ditentukan sebelumnya dalam langganan. Properti Hitung memperlihatkan berapa kali tag telah diterapkan ke sumber daya dan grup sumber daya dalam langganan.

Contoh 2: Mendapatkan tag berdasarkan nama

PS C:\>Get-AzureRmTag -Name "Department"

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3

Perintah ini mendapatkan informasi terperinci tentang tag Departemen dan nilainya. Properti Hitung memperlihatkan berapa kali tag dan setiap nilainya telah diterapkan ke sumber daya dan grup sumber daya dalam langganan.

Contoh 3: Mendapatkan nilai dari semua tag

PS C:\>Get-AzureRmTag -Detailed

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3


Name:   FY2015
Count:  2


Name:   CostCenter
Count:  20
Values: 

        Name        Count
        ==========  =====

        0001          5
        0002         10
        0003          5

Perintah ini menggunakan parameter Terperinci untuk mendapatkan informasi terperinci tentang semua tag yang telah ditentukan sebelumnya dalam langganan. Menggunakan parameter Terperinci setara dengan menggunakan parameter Nama untuk setiap tag.

Parameter

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

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

-Detailed

Menunjukkan bahwa operasi ini menambahkan informasi tentang nilai tag ke output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama tag yang akan didapatkan. Secara default, Get-AzureRmTag mendapatkan informasi dasar tentang semua tag yang telah ditentukan sebelumnya dalam langganan. Saat Anda menentukan parameter Nama , parameter Terperinci tidak berpengaruh.

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

Input

String

SwitchParameter

Output

PSTag