Set-AzResourceGroup

  • Reference
Modul:
Az.Resources

Upraví skupinu prostředků.

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

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

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á k použití značek ve skupině prostředků ContosoRG parametr Set-AzResourceGroup 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ů

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.

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

-DefaultProfile

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

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

-Id

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

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

-Name

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

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

-Pre

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 rutiny 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 rutiny Get-AzResourceGroup s výjimkou značky, kterou chcete odstranit. Pokud chcete odstranit všechny značky ze skupiny prostředků, zadejte prázdnou tabulku hash: @{}.

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

Vstupy

String

Hashtable

Výstupy

PSResourceGroup