Set-AzResourceGroup

Modul:
Az.Resources Module

Upraví skupinu prostředků.

Syntax

SetByResourceGroupName (Výchozí) 

Set-AzResourceGroup
    [-Tag] <Hashtable>
    -Name <String>
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

SetByResourceGroupId 

Set-AzResourceGroup
    [-Tag] <Hashtable>
    -Id <String>
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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á 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

-AcquirePolicyToken

Získejte token Azure Policy automaticky pro tuto operaci prostředku.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ApiVersion

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ChangeReference

ID zdroje odkazu na změnu pro tuto operaci prostředku.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Id

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IdentifikátorSkupinyZdrojů, ResourceId

Sady parametrů

SetByResourceGroupId
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ResourceGroupName

Sady parametrů

SetByResourceGroupName
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Pre

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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 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: @{}.

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Štítky

Sady parametrů

(All)
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Hashtable

Výstupy

PSResourceGroup