Sdílet prostřednictvím

Get-AzTag

  • Reference
Modul:
Az.Resources

Získá předdefinované značky Azure | Získá celou sadu značek pro prostředek nebo předplatné.

Syntaxe

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

Description

GetPredefinedTagSet: Rutina Get-AzTag získá předdefinované značky Azure ve vašem předplatném. Tato rutina vrátí základní informace o značkách nebo podrobných informacích o značkách a jejich hodnotách. Všechny výstupní objekty zahrnují vlastnost Count, která představuje počet prostředků a skupin prostředků, na které byly použity značky a hodnoty. Modul Azure Tags, který Get-AzTag je součástí, který vám může pomoct se správou předdefinovaných značek Azure. Značka Azure je pár název-hodnota, který můžete použít ke kategorizaci prostředků a skupin prostředků Azure, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům a skupinám. Značky můžete definovat a používat v jednom kroku, ale předdefinované značky umožňují vytvořit standardní, konzistentní, předvídatelné názvy a hodnoty pro značky ve vašem předplatném. K vytvoření předdefinované značky použijte rutinu New-AzTag. Pokud chcete použít předdefinovanou značku na skupinu prostředků, použijte parametr Tag rutiny New-AzTag. Pokud chcete prohledat skupiny prostředků konkrétní název značky nebo název a hodnotu, použijte parametr Tag rutiny Get-AzResourceGroup.

GetByResourceIdParameterSet: Rutina Get-AzTag Resource Id získá celou sadu značek prostředku nebo předplatného.

Příklady

Příklad 1: Získání všech předdefinovaných značek

Get-AzTag

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

Department    5
FY2015        2
CostCenter   20

Tento příkaz získá všechny předdefinované značky v předplatném. Vlastnost Count ukazuje, kolikrát byla značka použita pro prostředky a skupiny prostředků v předplatném.

Příklad 2: Získání značky podle názvu

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Tento příkaz získá podrobné informace o značce Oddělení a jejích hodnotách. Vlastnost Count zobrazuje, kolikrát byla značka a každá z jejích hodnot použita pro prostředky a skupiny prostředků v předplatném.

Příklad 3: Získání hodnot všech značek

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

Tento příkaz používá parametr Podrobné k získání podrobných informací o všech předdefinovaných značkách v předplatném. Použití parametru Detailed je ekvivalentem použití parametru Name pro každou značku.

Příklad 4: Získání celé sady značek v předplatném

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

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

Tento příkaz získá celou sadu značek v předplatném s {subId}.

Příklad 5: Získání celé sady značek pro prostředek

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

Tento příkaz získá celou sadu značek prostředku pomocí {resourceId}.

Parametry

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Detailed

Označuje, že tato operace přidá do výstupu informace o hodnotách značek.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Název předdefinované značky Ve výchozím nastavení Get-AzTag získá základní informace o všech předdefinovaných značkách v předplatném. Když zadáte parametr Name, nemá parametr Podrobný žádný vliv.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceId

Identifikátor prostředku pro označenou entitu. Prostředek, skupina prostředků nebo předplatné můžou být označené.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

SwitchParameter

Výstupy

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