Bagikan melalui

Get-AzTag

  • Referensi
Modul:
Az.Resources

Mendapatkan tag Azure yang telah ditentukan sebelumnya | Mendapatkan seluruh kumpulan tag pada sumber daya atau langganan.

Sintaks

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

Deskripsi

GetPredefinedTagSet: Cmdlet Get-AzTag 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 Azure Tags yang get-AzTag 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-AzTag. Untuk menerapkan tag yang telah ditentukan sebelumnya ke grup sumber daya, gunakan parameter Tag cmdlet New-AzTag. Untuk mencari grup sumber daya untuk nama atau nama dan nilai tag tertentu, gunakan parameter Tag cmdlet Get-AzResourceGroup.

GetByResourceIdParameterSet: Cmdlet Get-AzTag dengan ResourceId mendapatkan seluruh kumpulan tag pada sumber daya atau langganan.

Contoh

Contoh 1: Mendapatkan semua tag yang telah ditentukan sebelumnya

Get-AzTag

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

Get-AzTag -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

Get-AzTag -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.

Contoh 4: Mendapatkan seluruh kumpulan tag pada langganan

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Perintah ini mendapatkan seluruh kumpulan tag pada langganan dengan {subId}.

Contoh 5: Mendapatkan seluruh kumpulan tag pada sumber daya

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Perintah ini mendapatkan seluruh set tag pada sumber daya dengan {resourceId}.

Parameter

-DefaultProfile

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

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Detailed

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

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

Jenis:String
Position:0
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ResourceId

Pengidentifikasi sumber daya untuk entitas yang ditandai. Sumber daya, grup sumber daya, atau langganan mungkin ditandai.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

Input

String

SwitchParameter

Output

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource