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é.

Syntax

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. Modul Značky Azure, který je součástí značky New-AzTag, vám může pomoct se správou předdefinovaných značek 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 pro prostředek nebo předplatné. 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 pomocí rutiny New-AzTag přidat do značky hodnoty. 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 zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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é.

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

-Tag

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

Type:	Hashtable
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

String

Hashtable

Výstupy

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

New-AzTag

Syntax

Description

Příklady

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

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

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

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

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

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

Parametry

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Vstupy

Výstupy

Váš názor

Další materiály

New-AzTag

Syntax

Description

Příklady

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

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

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

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

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

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

Parametry

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Vstupy

Výstupy

Související odkazy

Váš názor

Další materiály