Condividi tramite

New-AzTag

  • Riferimento
Modulo:
Az.Resources

Crea un tag di Azure predefinito o aggiunge valori a un tag esistente | Crea o aggiorna l'intero set di tag in una risorsa o una sottoscrizione.

Sintassi

New-AzTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTag
   [-ResourceId] <String>
   [-Tag] <Hashtable>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

CreatePredefinedTagSet: il cmdlet New-AzTag crea un tag di Azure predefinito con un valore predefinito facoltativo. È anche possibile usarlo per aggiungere valori aggiuntivi ai tag predefiniti esistenti. Per creare un tag predefinito, immettere un nome di tag univoco. Per aggiungere un valore a un tag predefinito esistente, specificare il nome del tag esistente e il nuovo valore. Questo cmdlet restituisce un oggetto che rappresenta il tag nuovo o modificato con i relativi valori e il numero di risorse a cui è stato applicato. Il modulo Tag di Azure di cui fa parte New-AzTag consente di 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 applicare un tag predefinito a una risorsa o a un gruppo di risorse, usare il parametro Tag del cmdlet New-AzTag. Per cercare gruppi di risorse con un nome o un nome e un valore di tag specificati, usare il parametro Tag del cmdlet Get-AzResourceGroup. Ogni tag ha un nome. I valori sono facoltativi. Un tag di Azure predefinito può avere più valori, ma quando si applica il tag a una risorsa o a un gruppo di risorse, si applicano il nome del tag e solo uno dei relativi valori. Ad esempio, è possibile creare un tag reparto predefinito con un valore per ogni reparto, ad esempio Finanza, Risorse umane e IT. Quando si applica il tag Reparto a una risorsa, si applica un solo valore predefinito, ad esempio Finance.

CreateByResourceIdParameterSet: il cmdlet New-AzTag con resourceId crea o aggiorna l'intero set di tag in una risorsa o una sottoscrizione. Questa operazione consente di aggiungere o sostituire l'intero set di tag nella risorsa o nella sottoscrizione specificata. L'entità specificata può avere un massimo di 50 tag.

Esempio

Esempio 1: Creare un tag predefinito

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             0     {}

Questo comando crea un tag predefinito denominato FY2015. Questo tag non ha valori. È possibile applicare un tag senza valori a una risorsa o a un gruppo di risorse oppure usare New-AzTag per aggiungere valori al tag. È anche possibile specificare un valore quando si applica il tag alla risorsa o al gruppo di risorse.

Esempio 2: Creare un tag predefinito con un valore

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 

        Name        Count
        =========   =====
        Finance     0

Questo comando crea un tag predefinito denominato Department con un valore Finance.

Esempio 3: Aggiungere un valore a un tag predefinito

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
New-AzTag -Name "Department" -Value "IT"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0
        IT          0

Questi comandi creano un tag predefinito denominato Department con due valori. Se il nome del tag esiste, New-AzTag aggiunge il valore al tag esistente anziché crearne uno nuovo.

Esempio 4: Usare un tag predefinito

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 

Set-AzResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}

Name:      EngineerBlog
Location:  East US
Resources: 
            
  Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US
    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001 

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 

Get-AzResourceGroup -Tag @{Name="CostCenter"}

Name:      EngineerBlog
Location:  East US
Resources: 
     Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US

    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001

I comandi in questo esempio creano e usano un tag predefinito.

Esempio 5: Crea o aggiorna l'intero set di tag in una sottoscrizione

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

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

Questo comando crea o aggiorna l'intero set di tag nella sottoscrizione con {subId}.

Esempio 6: Crea o aggiorna l'intero set di tag in una risorsa

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Questo comando crea o aggiorna l'intero set di tag nella risorsa con {resourceId}.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-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

-Name

Specifica il nome del tag predefinito. Per creare un nuovo tag predefinito, immettere un nome univoco. Per aggiungere un valore a un tag esistente, immettere il nome del tag esistente. Se un tag predefinito esistente ha il nome specificato, New-AzTag aggiunge il valore specificato, se presente, al tag con tale nome anziché creare un nuovo tag.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
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:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tag

Tag da inserire nella risorsa.

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

-Value

Specifica un valore di tag predefinito. I tag predefiniti possono avere più valori, ma è possibile immettere un solo valore in ogni comando. Questo parametro è facoltativo, perché i tag possono avere nomi senza valori.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

Hashtable

Output

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