Sdílet prostřednictvím

New-AzTag

  • Reference
Modul:
Az.Resources

Vytvoří předdefinovanou značku Azure nebo přidá hodnoty do existující značky | Vytvoří nebo aktualizuje celou sadu značek pro prostředek nebo předplatné.

Syntaxe

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

Description

CreatePredefinedTagSet: Rutina New-AzTag vytvoří předdefinovanou značku Azure s volitelnou předdefinovanou hodnotou. Můžete ho také použít k přidání dalších hodnot do existujících předdefinovaných značek. Pokud chcete vytvořit předdefinovanou značku, zadejte jedinečný název značky. Pokud chcete přidat hodnotu k existující předdefinované značce, zadejte název existující značky a novou hodnotu. Tato rutina vrátí objekt, který představuje novou nebo upravenou značku se svými hodnotami a počtem prostředků, na které byla použita. Součástí modulu Značky Azure, který New-AzTag, vám může pomoct spravovat předdefinované značky Azure. Značka Azure je pár název-hodnota, který můžete použít ke kategorizaci prostředků a skupin prostředků Azure, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům a skupinám. Značky můžete definovat a používat v jednom kroku, ale předdefinované značky umožňují vytvořit standardní, konzistentní, předvídatelné názvy a hodnoty pro značky ve vašem předplatném. Pokud chcete použít předdefinovanou značku na prostředek nebo skupinu prostředků, použijte parametr Tag rutiny New-AzTag. Pokud chcete vyhledat skupiny prostředků se zadaným názvem značky nebo názvem a hodnotou, použijte parametr Tag rutiny Get-AzResourceGroup. Každá značka má název. Hodnoty jsou volitelné. Předdefinovaná značka Azure může mít více hodnot, ale když značku použijete u prostředku nebo skupiny prostředků, použijete název značky a jenom jednu z jejích hodnot. Můžete například vytvořit předdefinovanou značku oddělení s hodnotou pro každé oddělení, například Finance, Lidské zdroje a IT. Když u prostředku použijete značku Oddělení, použijete pouze jednu předdefinovanou hodnotu, například Finance.

CreateByResourceIdParameterSet: rutina New-AzTag s ResourceId vytvoří nebo aktualizuje celou sadu značek prostředku nebo předplatného. Tato operace umožňuje přidat nebo nahradit celou sadu značek u zadaného prostředku nebo předplatného. Zadaná entita může mít maximálně 50 značek.

Příklady

Příklad 1: Vytvoření předdefinované značky

New-AzTag -Name "FY2015"

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

Tento příkaz vytvoří předdefinovanou značku s názvem FY2015. Tato značka nemá žádné hodnoty. Značku bez hodnot můžete použít u prostředku nebo skupiny prostředků, nebo můžete k přidání hodnot do značky použít New-AzTag. Hodnotu můžete zadat také při použití značky na prostředek nebo skupinu prostředků.

Příklad 2: Vytvoření předdefinované značky s hodnotou

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

Name:   Department
Count:  0
Values: 

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

Tento příkaz vytvoří předdefinovanou značku s názvem Oddělení s hodnotou Finance.

Příklad 3: Přidání hodnoty k předdefinované značce

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

Tyto příkazy vytvoří předdefinovanou značku s názvem Oddělení se dvěma hodnotami. Pokud název značky existuje, New-AzTag místo vytvoření nové značky přidá hodnotu k existující značce.

Příklad 4: Použití předdefinované značky

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

Příkazy v tomto příkladu vytvoří a použijí předdefinovanou značku.

Příklad 5: Vytvoří nebo aktualizuje celou sadu značek v předplatném.

$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

Tento příkaz vytvoří nebo aktualizuje celou sadu značek v předplatném pomocí {subId}.

Příklad 6: Vytvoří nebo aktualizuje celou sadu značek prostředku.

$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

Tento příkaz vytvoří nebo aktualizuje celou sadu značek prostředku pomocí {resourceId}.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje předdefinovaný název značky. Pokud chcete vytvořit novou předdefinovanou značku, zadejte jedinečný název. Pokud chcete přidat hodnotu k existující značce, zadejte název existující značky. Pokud má existující předdefinovaná značka zadaný název, New-AzTag přidá zadanou hodnotu (pokud existuje) ke značce s tímto názvem místo vytvoření nové značky.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceId

Identifikátor prostředku pro entitu, která je označena. Prostředek, skupina prostředků nebo předplatné můžou být označené.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Značky, které se mají vložit do prostředku.

Typ:Hashtable
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Value

Určuje předdefinovanou hodnotu značky. Předdefinované značky můžou mít více hodnot, ale v každém příkazu můžete zadat jenom jednu hodnotu. Tento parametr je nepovinný, protože značky můžou mít názvy bez hodnot.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Hashtable

Výstupy

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