New-AzTag

Referencia

Modul:: Az.Resources

Előre definiált Azure-címkét hoz létre, vagy értékeket ad hozzá egy meglévő címkéhez | Létrehozza vagy frissíti egy erőforrás vagy előfizetés címkéinek teljes készletét.

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: A New-AzTag parancsmag egy előre definiált Azure-címkét hoz létre egy opcionális előre definiált értékkel. Használatával további értékeket is hozzáadhat a meglévő előre definiált címkékhez. Előre definiált címke létrehozásához adjon meg egy egyedi címkenevet. Ha értéket szeretne hozzáadni egy meglévő előre definiált címkéhez, adja meg a meglévő címke nevét és az új értéket. Ez a parancsmag egy objektumot ad vissza, amely az új vagy módosított címkét jelöli az értékeivel és azoknak az erőforrásoknak a számával, amelyekre alkalmazták. A New-AzTag részét képező Azure Tags modul segíthet az előre definiált Azure-címkék kezelésében. Az Azure-címke egy név-érték pár, amellyel kategorizálhatja az Azure-erőforrásokat és erőforráscsoportokat, például részlegek vagy költséghely szerint, illetve nyomon követheti az erőforrásokkal és csoportokkal kapcsolatos megjegyzéseket vagy megjegyzéseket. Címkéket egyetlen lépésben definiálhat és alkalmazhat, de az előre definiált címkék lehetővé teszik az előfizetésben lévő címkék szabványos, konzisztens, kiszámítható neveinek és értékeinek létrehozását. Ha előre definiált címkét szeretne alkalmazni egy erőforrásra vagy erőforráscsoportra, használja a New-AzTag parancsmag Címke paraméterét. Ha egy megadott címkenévvel vagy névvel és értékkel rendelkező erőforráscsoportokat szeretne keresni, használja a Get-AzResourceGroup parancsmag Címke paraméterét. Minden címkének van neve. Az értékek megadása nem kötelező. Az előre definiált Azure-címkék több értékkel is rendelkezhetnek, de ha egy erőforrásra vagy erőforráscsoportra alkalmazza a címkét, akkor a címke nevét és csak az egyik értékét alkalmazza. Létrehozhat például egy előre definiált részlegcímkét az egyes részlegekhez, például a Pénzügyhez, az Emberi erőforrásokhoz és az informatikai részlegekhez. Amikor a Részleg címkét egy erőforrásra alkalmazza, csak egy előre definiált értéket alkalmaz, például a Pénzügyet.

CreateByResourceIdParameterSet: A ResourceId-et tartalmazó New-AzTag parancsmag létrehozza vagy frissíti egy erőforrás vagy előfizetés címkéinek teljes készletét. Ez a művelet lehetővé teszi a címkék teljes készletének hozzáadását vagy cseréjét a megadott erőforráson vagy előfizetésen. A megadott entitás legfeljebb 50 címkével rendelkezhet.

Példák

1. példa: Előre definiált címke létrehozása

New-AzTag -Name "FY2015"

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

Ez a parancs létrehoz egy előre definiált címkét FY2015 néven. Ez a címke nem tartalmaz értékeket. Alkalmazhat érték nélküli címkét egy erőforrásra vagy erőforráscsoportra, vagy a New-AzTag használatával is hozzáadhat értékeket a címkéhez. Értéket is megadhat, ha a címkét az erőforrásra vagy erőforráscsoportra alkalmazza.

2. példa: Előre definiált címke létrehozása értékkel

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

Name:   Department
Count:  0
Values: 

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

Ez a parancs létrehoz egy Részleg nevű előre definiált címkét, amelynek értéke pénzügy.

3. példa: Érték hozzáadása előre definiált címkéhez

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

Ezek a parancsok létrehoznak egy részleg nevű előre definiált címkét két értékkel. Ha a címke neve létezik, a New-AzTag új címke létrehozása helyett hozzáadja az értéket a meglévő címkéhez.

4. példa: Előre definiált címke használata

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

A példában szereplő parancsok előre definiált címkét hoznak létre és használnak.

5. példa: Az előfizetés teljes címkekészletének létrehozása vagy frissítése

$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

Ez a parancs létrehozza vagy frissíti az előfizetés teljes címkéit a(z) {subId} paranccsal.

6. példa: Az erőforrás teljes címkekészletének létrehozása vagy frissítése

$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

Ez a parancs létrehozza vagy frissíti az erőforrás teljes címkekészletét a(z) {resourceId} paranccsal.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:	IAzureContextContainer
Aliasok:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Name

Megadja az előre definiált címkenevet. Új előre definiált címke létrehozásához adjon meg egy egyedi nevet. Ha értéket szeretne hozzáadni egy meglévő címkéhez, adja meg a meglévő címke nevét. Ha egy meglévő előre definiált címke a megadott névvel rendelkezik, a New-AzTag az új címke létrehozása helyett hozzáadja a megadott értéket, ha van ilyen.

Típus:	String
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ResourceId

A címkézett entitás erőforrás-azonosítója. Előfordulhat, hogy egy erőforrás, egy erőforráscsoport vagy egy előfizetés címkézve van.

Típus:	String
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Tag

Az erőforrásra helyezendő címkék.

Típus:	Hashtable
Position:	1
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Value

Előre definiált címkeértéket ad meg. Az előre definiált címkék több értékkel is rendelkezhetnek, de minden parancsban csak egy értéket adhat meg. Ez a paraméter nem kötelező, mert a címkékben értékek nélküli nevek is lehetnek.

Típus:	String
Position:	1
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

String

Hashtable

Kimenetek

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

Megosztás a következőn keresztül:

New-AzTag

Syntax

Description

Példák

1. példa: Előre definiált címke létrehozása

2. példa: Előre definiált címke létrehozása értékkel

3. példa: Érték hozzáadása előre definiált címkéhez

4. példa: Előre definiált címke használata

5. példa: Az előfizetés teljes címkekészletének létrehozása vagy frissítése

6. példa: Az erőforrás teljes címkekészletének létrehozása vagy frissítése

Paraméterek

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Bevitelek

Kimenetek

További források

Megosztás a következőn keresztül:

New-AzTag

Syntax

Description

Példák

1. példa: Előre definiált címke létrehozása

2. példa: Előre definiált címke létrehozása értékkel

3. példa: Érték hozzáadása előre definiált címkéhez

4. példa: Előre definiált címke használata

5. példa: Az előfizetés teljes címkekészletének létrehozása vagy frissítése

6. példa: Az erőforrás teljes címkekészletének létrehozása vagy frissítése

Paraméterek

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Bevitelek

Kimenetek

Kapcsolódó hivatkozások

További források