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

Set-AzResourceGroup

  • Referencia
Modul:
Az.Resources

Módosít egy erőforráscsoportot.

Syntax

Set-AzResourceGroup
   -Name <String>
   [-Tag] <Hashtable>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzResourceGroup
   [-Tag] <Hashtable>
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

A Set-AzResourceGroup parancsmag módosítja egy erőforráscsoport tulajdonságait. Ezzel a parancsmaggal hozzáadhatja, módosíthatja vagy törölheti az erőforráscsoportra alkalmazott Azure-címkéket. Adja meg a Név paramétert az erőforráscsoport és a Címke paraméter azonosításához a címkék módosításához. Ezzel a parancsmaggal nem módosíthatja egy erőforráscsoport nevét.

Példák

1. példa: Címke alkalmazása erőforráscsoportra

Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Ez a parancs egy informatikai értékkel rendelkező részlegcímkét alkalmaz egy olyan erőforráscsoportra, amely nem rendelkezik meglévő címkékkel.

2. példa: Címkék hozzáadása erőforráscsoporthoz

$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags

Ez a példa egy Jóváhagyott és egy FY2016 címkét tartalmazó állapotcímkét ad hozzá egy meglévő címkékkel rendelkező erőforráscsoporthoz. Mivel a megadott címkék lecserélik a meglévő címkéket, fel kell vennie a meglévő címkéket az új címkegyűjteménybe, különben elveszíti őket. Az első parancs lekéri a ContosoRG erőforráscsoportot, és a pont metódus használatával lekéri a Címkék tulajdonság értékét. A parancs a címkéket a $Tags változóban tárolja. A második parancs lekéri a címkéket a $Tags változóban. A harmadik parancs a += hozzárendelési operátorral adja hozzá az Állapot és FY2016 címkéket a $Tags változóban lévő címkék tömbjében. A negyedik parancs a Set-AzResourceGroup Címke paraméterével alkalmazza a címkéket a $Tags változóban a ContosoRG erőforráscsoportra. Az ötödik parancs lekéri a ContosoRG erőforráscsoportra alkalmazott összes címkét. A kimenet azt mutatja, hogy az erőforráscsoport rendelkezik a Részleg címkével és a két új címkével, az Állapot és a FY2015 címkével.

3. példa: Egy erőforráscsoport összes címkéje törlése

Set-AzResourceGroup -Name "ContosoRG" -Tag @{}

Ez a parancs egy üres kivonattábla-értékkel rendelkező Címke paramétert ad meg a ContosoRG erőforráscsoport összes címkéjének törléséhez.

Paraméterek

-ApiVersion

Az erőforrás-szolgáltató által támogatott API-verziót adja meg. Az alapértelmezett verziótól eltérő verziót is megadhat.

Típus:String
Position:Named
Alapértelmezett érték:None
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

-Id

Megadja a módosítani kívánt erőforráscsoport azonosítóját.

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

-Name

Megadja a módosítani kívánt erőforráscsoport nevét.

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

-Pre

Azt jelzi, hogy ez a parancsmag a kiadás előtti API-verziókat veszi figyelembe, amikor automatikusan meghatározza a használni kívánt verziót.

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

-Tag

Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"} A címke egy név-érték pár, amelyet létrehozhat és alkalmazhat az erőforrásokra és erőforráscsoportokra. Miután címkéket rendelt az erőforrásokhoz és csoportokhoz, a Get-AzResource és a Get-AzResourceGroup címkeparaméterével címkenév vagy név és érték alapján kereshet erőforrásokat és csoportokat. Címkék használatával kategorizálhatja az erőforrásokat, például részleg vagy költséghely szerint, vagy nyomon követheti az erőforrásokra vonatkozó megjegyzéseket vagy megjegyzéseket. Címke hozzáadásához vagy módosításához le kell cserélnie az erőforráscsoport címkéinek gyűjteményét. Címke törléséhez írjon be egy kivonattáblát, amelyben az erőforráscsoportra jelenleg alkalmazott összes címke szerepel a Get-AzResourceGroupban, kivéve a törölni kívánt címkét. Ha egy erőforráscsoport összes címkéét törölni szeretné, adjon meg egy üres kivonattáblát: @{}.

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

Bevitelek

String

Hashtable

Kimenetek

PSResourceGroup