Dela via


Get-AzTag

Hämtar fördefinierade Azure-taggar | Hämtar hela uppsättningen taggar för en resurs eller prenumeration.

Syntax

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

Description

GetPredefinedTagSet: Get-AzTag-cmdleten hämtar fördefinierade Azure-taggar i din prenumeration. Den här cmdleten returnerar grundläggande information om taggarna eller detaljerad information om taggar och deras värden. Alla utdataobjekt innehåller egenskapen Count som representerar antalet resurser och resursgrupper som taggarna och värdena har tillämpats på. Modulen Azure-taggar som Get-AzTag ingår i kan hjälpa dig att hantera fördefinierade Azure-taggar. En Azure-tagg är ett namn/värde-par som du kan använda för att kategorisera dina Azure-resurser och resursgrupper, till exempel efter avdelning eller kostnadsställe, eller för att spåra anteckningar eller kommentarer om resurser och grupper. Du kan definiera och tillämpa taggar i ett enda steg, men med fördefinierade taggar kan du upprätta standard, konsekventa, förutsägbara namn och värden för taggarna i din prenumeration. Om du vill skapa en fördefinierad tagg använder du cmdleten New-AzTag. Om du vill tillämpa en fördefinierad tagg på en resursgrupp använder du parametern Tag i cmdleten New-AzTag. Om du vill söka efter ett specifikt taggnamn eller namn och värde i resursgrupper använder du parametern Tag i cmdleten Get-AzResourceGroup.

GetByResourceIdParameterSet: Get-AzTag-cmdleten med ett ResourceId hämtar hela uppsättningen taggar på en resurs eller prenumeration.

Exempel

Exempel 1: Hämta alla fördefinierade taggar

Get-AzTag

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

Department    5
FY2015        2
CostCenter   20

Det här kommandot hämtar alla fördefinierade taggar i prenumerationen. Egenskapen Count visar hur många gånger taggen har tillämpats på resurser och resursgrupper i prenumerationen.

Exempel 2: Hämta en tagg efter namn

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Det här kommandot hämtar detaljerad information om taggen Avdelning och dess värden. Egenskapen Count visar hur många gånger taggen och var och en av dess värden har tillämpats på resurser och resursgrupper i prenumerationen.

Exempel 3: Hämta värden för alla taggar

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

Det här kommandot använder parametern Detaljerad för att få detaljerad information om alla fördefinierade taggar i prenumerationen. Att använda parametern Detaljerad motsvarar att använda parametern Namn för varje tagg.

Exempel 4: Hämta hela uppsättningen taggar i en prenumeration

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

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

Det här kommandot hämtar hela uppsättningen taggar i prenumerationen med {subId}.

Exempel 5: Hämta hela uppsättningen taggar på en resurs

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

Det här kommandot hämtar hela uppsättningen taggar på resursen med {resourceId}.

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Detailed

Anger att den här åtgärden lägger till information om taggvärden i utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på den fördefinierade taggen. Som standard hämtar Get-AzTag grundläggande information om alla fördefinierade taggar i prenumerationen. När du anger parametern Namn har parametern Detaljerad ingen effekt.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceId

Resursidentifieraren för den taggade entiteten. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

SwitchParameter

Utdata

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