Get-AzureRmTag

Ottiene i tag di Azure predefiniti.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet Get-AzureRmTag 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-AzureRMTag 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-AzureRmTag. Per applicare un tag predefinito a un gruppo di risorse, usare il parametro Tag del cmdlet New-AzureRmTag. Per cercare un nome di tag o un nome e un valore specifici nei gruppi di risorse, usare il parametro Tag del cmdlet Get-AzureRMResourceGroup.

Esempio

Esempio 1: Ottenere tutti i tag predefiniti

PS C:\>Get-AzureRmTag

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

PS C:\>Get-AzureRmTag -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

PS C:\>Get-AzureRmTag -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 Detailed 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.

Parametri

-DefaultProfile

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

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

-Detailed

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

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

-Name

Specifica il nome del tag da ottenere. Per impostazione predefinita, Get-AzureRmTag ottiene informazioni di base su tutti i tag predefiniti nella sottoscrizione. Quando si specifica il parametro Name , il parametro Detailed non ha alcun effetto.

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

Input

String

SwitchParameter

Output

PSTag