Sdílet prostřednictvím

Set-AzureRmResourceGroup

  • Reference
Modul:
AzureRM.Resources

Upraví skupinu prostředků.

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Rutina Set-AzureRmResourceGroup upravuje vlastnosti skupiny prostředků. Pomocí této rutiny můžete přidat, změnit nebo odstranit značky Azure použité u skupiny prostředků. Zadejte parametr Name k identifikaci skupiny prostředků a parametru Tag pro úpravu značek. Tuto rutinu nelze použít ke změně názvu skupiny prostředků.

Příklady

Příklad 1: Použití značky u skupiny prostředků

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Tento příkaz použije značku oddělení s hodnotou IT pro skupinu prostředků, která nemá žádné existující značky.

Příklad 2: Přidání značek do skupiny prostředků

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

Tento příklad přidá značku Status s hodnotou Schváleno a značka FY2016 do skupiny prostředků, která má existující značky. Protože vámi zadané značky nahradí existující značky, musíte zahrnout existující značky do nové kolekce značek nebo je ztratíte. První příkaz získá skupinu prostředků ContosoRG a použije metodu tečky k získání hodnoty jeho vlastnosti Tags. Příkaz uloží značky do proměnné $Tags. Druhý příkaz získá značky v proměnné $Tags. Třetí příkaz pomocí operátoru přiřazení += přidá značky Status a FY2016 do pole značek v proměnné $Tags. Čtvrtý příkaz používá k použití značek ve skupině prostředků ContosoRG parametr Set-AzureRmResourceGroup značky v proměnné $Tags. Pátý příkaz získá všechny značky použité pro skupinu prostředků ContosoRG. Výstup ukazuje, že skupina prostředků má značku Oddělení a dvě nové značky, Stav a FY2015.

Příklad 3: Odstranění všech značek pro skupinu prostředků

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{}

Tento příkaz určuje parametr Tag s prázdnou hodnotou tabulky hash, která odstraní všechny značky ze skupiny prostředků ContosoRG.

Parametry

-ApiVersion

Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID skupiny prostředků, která se má upravit.

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název skupiny prostředků, která se má upravit.

Typ:String
Aliasy:ResourceGroupName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"} Značka je pár název-hodnota, který můžete vytvořit a použít u prostředků a skupin prostředků. Po přiřazení značek k prostředkům a skupinám můžete pomocí parametru Tag Get-AzureRmResource a Get-AzureRmResourceGroup vyhledat prostředky a skupiny podle názvu značky nebo názvu a hodnoty. Značky můžete použít ke kategorizaci prostředků, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům. Pokud chcete přidat nebo změnit značku, musíte nahradit kolekci značek pro skupinu prostředků. Pokud chcete odstranit značku, zadejte tabulku hash se všemi značkami, které jsou aktuálně použity pro skupinu prostředků, z Get-AzureRmResourceGroup s výjimkou značky, kterou chcete odstranit. Pokud chcete odstranit všechny značky ze skupiny prostředků, zadejte prázdnou tabulku hash: @{}.

Typ:Hashtable
Aliasy:Tags
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

Microsoft.Azure.Commands.Resources.Models.PSResourceGroup