Condividi tramite

Get-AzTag

  • Riferimento
Modulo:
Az.Resources

Ottiene i tag di Azure predefiniti | Ottiene l'intero set di tag in una risorsa o una sottoscrizione.

Sintassi

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

Descrizione

GetPredefinedTagSet: il cmdlet Get-AzTag ottiene tag di Azure predefiniti nella sottoscrizione. Questo cmdlet restituisce informazioni di base sui tag o informazioni dettagliate sui tag e sui relativi valori. Tutti gli oggetti di output includono una proprietà Count che rappresenta il numero di risorse e gruppi di risorse a cui sono stati applicati i tag e i valori. Il modulo Tag di Azure che Get-AzTag fa parte di può essere utile per gestire i tag di Azure predefiniti. Un tag di Azure è una coppia nome-valore che è possibile usare per classificare le risorse e i gruppi di risorse di Azure, ad esempio per reparto o centro di costo, oppure per tenere traccia di note o commenti relativi alle risorse e ai gruppi. È possibile definire e applicare tag in un singolo passaggio, ma i tag predefiniti consentono di definire nomi e valori standard, coerenti, prevedibili per i tag nella sottoscrizione. Per creare un tag predefinito, usare il cmdlet New-AzTag. Per applicare un tag predefinito a un gruppo di risorse, usare il parametro tag del cmdlet New-AzTag. Per cercare un nome o un nome e un valore specifici nei gruppi di risorse, usare il parametro tag del cmdlet Get-AzResourceGroup.

GetByResourceIdParameterSet: il cmdlet Get-AzTag con un ResourceId ottiene l'intero set di tag in una risorsa o una sottoscrizione.

Esempio

Esempio 1: Ottenere tutti i tag predefiniti

Get-AzTag

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

Department    5
FY2015        2
CostCenter   20

Questo comando ottiene tutti i tag predefiniti nella sottoscrizione. La proprietà Count mostra quante volte il tag è stato applicato alle risorse e ai gruppi di risorse nella sottoscrizione.

Esempio 2: Ottenere un tag in base al nome

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Questo comando ottiene informazioni dettagliate sul tag Department e sui relativi valori. La proprietà Count mostra quante volte il tag e ognuno dei relativi valori è stato applicato alle risorse e ai gruppi di risorse nella sottoscrizione.

Esempio 3: Ottenere i valori di tutti i 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

Questo comando usa il parametro dettagliato per ottenere informazioni dettagliate su tutti i tag predefiniti nella sottoscrizione. L'uso del parametro Detailed equivale all'uso del parametro Name per ogni tag.

Esempio 4: Ottenere l'intero set di tag in una sottoscrizione

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

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

Questo comando ottiene l'intero set di tag nella sottoscrizione con {subId}.

Esempio 5: Ottenere l'intero set di tag in una risorsa

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

Questo comando ottiene l'intero set di tag nella risorsa con {resourceId}.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Detailed

Indica che questa operazione aggiunge informazioni sui valori dei tag all'output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome del tag predefinito. Per impostazione predefinita, Get-AzTag ottiene informazioni di base su tutti i tag predefiniti nella sottoscrizione. Quando si specifica il parametro Nome , il parametro dettagliato non ha alcun effetto.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceId

Identificatore della risorsa per l'entità contrassegnata. È possibile contrassegnare una risorsa, un gruppo di risorse o una sottoscrizione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

SwitchParameter

Output

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