Get-AzTag
Előre definiált Azure-címkék lekérdezhetők | Lekéri egy erőforrás vagy előfizetés címkéinek teljes készletét.
Syntax
Get-AzTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzTag
-ResourceId <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
GetPredefinedTagSet: A Get-AzTag parancsmag előre definiált Azure-címkéket kap az előfizetésében. Ez a parancsmag alapvető információkat ad vissza a címkékről, illetve részletes információkat a címkékről és azok értékeiről. Minden kimeneti objektum tartalmaz egy Darabszám tulajdonságot, amely azoknak az erőforrásoknak és erőforráscsoportoknak a számát jelöli, amelyekre a címkéket és értékeket alkalmazták. A Get-AzTag részét képező Azure Tags modul segíthet az előre definiált Azure-címkék kezelésében. Az Azure-címke egy név-érték pár, amellyel kategorizálhatja az Azure-erőforrásokat és erőforráscsoportokat, például részlegek vagy költséghely szerint, illetve nyomon követheti az erőforrásokkal és csoportokkal kapcsolatos megjegyzéseket vagy megjegyzéseket. Címkéket egyetlen lépésben definiálhat és alkalmazhat, de az előre definiált címkék lehetővé teszik az előfizetésben lévő címkék szabványos, konzisztens, kiszámítható neveinek és értékeinek létrehozását. Előre definiált címke létrehozásához használja a New-AzTag parancsmagot. Ha előre definiált címkét szeretne alkalmazni egy erőforráscsoportra, használja a New-AzTag parancsmag Címke paraméterét. Ha erőforráscsoportokat szeretne keresni egy adott címkenévre vagy névre és értékre, használja a Get-AzResourceGroup parancsmag Címke paraméterét.
GetByResourceIdParameterSet: A ResourceId-et tartalmazó Get-AzTag parancsmag lekéri egy erőforrás vagy előfizetés címkéinek teljes készletét.
Példák
1. példa: Az összes előre definiált címke lekérése
Get-AzTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20
Ez a parancs lekéri az előfizetésben az összes előre definiált címkét. A Darabszám tulajdonság azt mutatja, hogy hányszor alkalmazták a címkét az előfizetés erőforrásaira és erőforráscsoportjaira.
2. példa: Címke lekérése név szerint
Get-AzTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
Ez a parancs részletes információkat kap a részlegcímkéről és értékeiről. A Darabszám tulajdonság azt mutatja, hogy a címke és az egyes értékek hányszor lettek alkalmazva az előfizetés erőforrásaira és erőforráscsoportjaira.
3. példa: Az összes címke értékeinek lekérése
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
Ez a parancs a Részletes paramétert használja az előfizetésben előre definiált címkék részletes információinak lekéréséhez. A Részletes paraméter használata egyenértékű az összes címke Név paraméterének használatával.
4. példa: Az előfizetés teljes címkekészletének lekérése
Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
tagKey1 tagValue1
tagKey2 tagValue2
Ez a parancs lekéri az előfizetés teljes címkéit a(z) {subId} paranccsal.
5. példa: Az erőforrás teljes címkekészletének lekérése
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
Ez a parancs lekéri az erőforrás teljes címkéinek készletét a(z) {resourceId} paranccsal.
Paraméterek
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Detailed
Azt jelzi, hogy ez a művelet információkat ad a címkeértékekről a kimenethez.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Az előre definiált címke neve. Alapértelmezés szerint a Get-AzTag alapszintű információkat kap az előfizetés összes előre definiált címkéjéről. A Név paraméter megadásakor a Részletes paraméternek nincs hatása.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ResourceId
A címkézett entitás erőforrás-azonosítója. Előfordulhat, hogy egy erőforrás, egy erőforráscsoport vagy egy előfizetés címkézve van.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Kimenetek
Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource