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

Set-AzureRmResourceGroup

  • Referencia
Modul:
AzureRM.Resources

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

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

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

Description

A Set-AzureRmResourceGroup 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

PS C:\>Set-AzureRmResourceGroup -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

PS C:\>$Tags = (Get-AzureRmResourceGroup -Name "ContosoRG").Tags
PS C:\> $Tags
PS C:\> $Tags += @{"Status"="Approved"; "FY2016"=$null}
PS C:\> Set-AzureRmResourceGroup -Name "ContosoRG" -Tag $Tags
PS C:> (Get-AzureRmResourceGroup -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-AzureRmResourceGroup 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

PS C:\>Set-AzureRmResourceGroup -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: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:0
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:0
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-AzureRmResource és a Get-AzureRmResourceGroup 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 az erőforráscsoportra jelenleg alkalmazott összes címkével a Get-AzureRmResourceGroupból, 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

None

Kimenetek

Microsoft.Azure.Commands.Resources.Models.PSResourceGroup