Set-AzResourceGroup

  • Referens
Modul:
Az.Resources

Ändrar en resursgrupp.

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

Cmdleten Set-AzResourceGroup ändrar egenskaperna för en resursgrupp. Du kan använda den här cmdleten för att lägga till, ändra eller ta bort De Azure-taggar som tillämpas på en resursgrupp. Ange parametern Namn för att identifiera resursgruppen och taggparametern för att ändra taggarna. Du kan inte använda den här cmdleten för att ändra namnet på en resursgrupp.

Exempel

Exempel 1: Tillämpa en tagg på en resursgrupp

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

Det här kommandot tillämpar en avdelningstagg med värdet IT för en resursgrupp som inte har några befintliga taggar.

Exempel 2: Lägga till taggar i en resursgrupp

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

I det här exemplet läggs en statustagg med värdet Godkänd och taggen FY2016 till en resursgrupp som har befintliga taggar. Eftersom taggarna du anger ersätter de befintliga taggarna måste du inkludera de befintliga taggarna i den nya taggsamlingen, annars förlorar du dem. Det första kommandot hämtar resursgruppen ContosoRG och använder dot-metoden för att hämta värdet för egenskapen Taggar. Kommandot lagrar taggarna i variabeln $Tags. Det andra kommandot hämtar taggarna i variabeln $Tags. Det tredje kommandot använder tilldelningsoperatorn += för att lägga till taggarna Status och FY2016 i matrisen med taggar i variabeln $Tags. Det fjärde kommandot använder taggparameternSet-AzResourceGroup för att tillämpa taggarna i variabeln $Tags på Resursgruppen ContosoRG. Det femte kommandot hämtar alla taggar som tillämpas på ContosoRG-resursgruppen. Utdata visar att resursgruppen har taggen Avdelning och de två nya taggarna, Status och FY2015.

Exempel 3: Ta bort alla taggar för en resursgrupp

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

Det här kommandot anger taggparametern med ett tomt hashtabellvärde för att ta bort alla taggar från Resursgruppen ContosoRG.

Parametrar

-ApiVersion

Anger den API-version som stöds av resursprovidern. Du kan ange en annan version än standardversionen.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

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

-Id

Anger ID för resursgruppen som ska ändras.

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

-Name

Anger namnet på resursgruppen som ska ändras.

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

-Pre

Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.

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

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"} En tagg är ett namn/värde-par som du kan skapa och tillämpa på resurser och resursgrupper. När du har tilldelat taggar till resurser och grupper kan du använda taggparametern Get-AzResource och Get-AzResourceGroup för att söka efter resurser och grupper efter taggnamn eller namn och värde. Du kan använda taggar för att kategorisera dina resurser, till exempel efter avdelning eller kostnadsställe, eller för att spåra anteckningar eller kommentarer om resurserna. Om du vill lägga till eller ändra en tagg måste du ersätta samlingen med taggar för resursgruppen. Om du vill ta bort en tagg anger du en hash-tabell med alla taggar som för närvarande tillämpas på resursgruppen, från Get-AzResourceGroup, förutom taggen som du vill ta bort. Om du vill ta bort alla taggar från en resursgrupp anger du en tom hash-tabell: @{}.

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

Indata

String

Hashtable

Utdata

PSResourceGroup