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.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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: @{}.

Type:Hashtable
Aliases:Tags
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

String

Hashtable

Kimenetek

PSResourceGroup