Delen via

Set-AzResourceGroup

  • Referentie
Module:
Az.Resources

Hiermee wijzigt u een resourcegroep.

Syntaxis

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

De cmdlet Set-AzResourceGroup wijzigt de eigenschappen van een resourcegroep. U kunt deze cmdlet gebruiken om de Azure-tags toe te voegen, te wijzigen of te verwijderen die zijn toegepast op een resourcegroep. Geef de parameter Name op om de resourcegroep en de parameter Tag te identificeren om de tags te wijzigen. U kunt deze cmdlet niet gebruiken om de naam van een resourcegroep te wijzigen.

Voorbeelden

Voorbeeld 1: Een tag toepassen op een resourcegroep

Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Met deze opdracht wordt een afdelingstag met een waarde van IT toegepast op een resourcegroep die geen bestaande tags heeft.

Voorbeeld 2: Tags toevoegen aan een resourcegroep

$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags

In dit voorbeeld wordt een statustag met de waarde Goedgekeurd en een FY2016-tag toegevoegd aan een resourcegroep met bestaande tags. Omdat de tags die u opgeeft de bestaande tags vervangen, moet u de bestaande tags in de nieuwe tagverzameling opnemen of verliezen ze. Met de eerste opdracht wordt de ContosoRG-resourcegroep opgehaald en wordt de puntmethode gebruikt om de waarde van de eigenschap Tags op te halen. Met de opdracht worden de tags opgeslagen in de variabele $Tags. Met de tweede opdracht worden de tags in de variabele $Tags. De derde opdracht maakt gebruik van de toewijzingsoperator += om de tags Status en FY2016 toe te voegen aan de matrix met tags in de variabele $Tags. De vierde opdracht gebruikt de parameter Tag van Set-AzResourceGroup om de tags in de $Tags variabele toe te passen op de ContosoRG-resourcegroep. Met de vijfde opdracht worden alle tags op de ContosoRG-resourcegroep toegepast. In de uitvoer ziet u dat de resourcegroep de tag Afdeling en de twee nieuwe tags, Status en FY2015 heeft.

Voorbeeld 3: Alle tags voor een resourcegroep verwijderen

Set-AzResourceGroup -Name "ContosoRG" -Tag @{}

Met deze opdracht geeft u de parameter Tag met een lege hash-tabelwaarde op om alle tags uit de ContosoRG-resourcegroep te verwijderen.

Parameters

-ApiVersion

Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u de id van de resourcegroep die moet worden gewijzigd.

Type:String
Aliassen:ResourceGroupId, ResourceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de resourcegroep die moet worden gewijzigd.

Type:String
Aliassen:ResourceGroupName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"} Een tag is een naam-waardepaar dat u kunt maken en toepassen op resources en resourcegroepen. Nadat u tags hebt toegewezen aan resources en groepen, kunt u de parameter Tag van Get-AzResource en Get-AzResourceGroup gebruiken om te zoeken naar resources en groepen op tagnaam of naam en waarde. U kunt tags gebruiken om uw resources te categoriseren, zoals per afdeling of kostenplaats, of om notities of opmerkingen over de resources bij te houden. Als u een tag wilt toevoegen of wijzigen, moet u de verzameling tags voor de resourcegroep vervangen. Als u een tag wilt verwijderen, voert u een hash-tabel in met alle tags die momenteel zijn toegepast op de resourcegroep, van Get-AzResourceGroup, met uitzondering van de tag die u wilt verwijderen. Als u alle tags uit een resourcegroep wilt verwijderen, geeft u een lege hashtabel op: @{}.

Type:Hashtable
Aliassen:Tags
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSResourceGroup