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 |