New-AzTag

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

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Input

String

Hashtable

Output

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

Collegamenti correlati

• Get-AzTag
• Remove-AzTag
• Update-AzTag