Get-AzTag

  • Referencia
Modul:
Az.Resources

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.

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

-Detailed

Azt jelzi, hogy ez a művelet információkat ad a címkeértékekről a kimenethez.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

Bevitelek

String

SwitchParameter

Kimenetek

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