Sdílet prostřednictvím

Set-AzResourceGroup

  • Reference
Modul:
Az.Resources

Upraví skupinu prostředků.

Syntaxe

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

Rutina Set-AzResourceGroup upraví 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ů. Zadáním parametru Name identifikujte skupinu prostředků a parametr 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ů

Set-AzResourceGroup -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ů

$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -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á parametr TagSet-AzResourceGroup k použití značek v proměnné $Tags pro skupinu prostředků ContosoRG. 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ů

Set-AzResourceGroup -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:AzContext, 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:Named
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:Named
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 použít parametr Tag Get-AzResource a Get-AzResourceGroup k vyhledání prostředků a skupin 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-AzResourceGroups 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

String

Hashtable

Výstupy

PSResourceGroup