Set-AzResourceGroup
Ändrar en resursgrupp.
Syntax
SetByResourceGroupName (Standard)
Set-AzResourceGroup
[-Tag] <Hashtable>
-Name <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResourceGroupId
Set-AzResourceGroup
[-Tag] <Hashtable>
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beskrivning
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 för 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokrar: | False |
| DontShow: | False |
Parametermängder
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter fastighetsnamn: | False |
| Värde från återstående argument: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Parameteregenskaper
| Typ: | IAzureContextContainer |
| Standardvärde: | None |
| Stöder jokrar: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Parametermängder
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter fastighetsnamn: | False |
| Värde från återstående argument: | False |
-Id
Anger ID för resursgruppen som ska ändras.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokrar: | False |
| DontShow: | False |
| Alias: | ResourceGroupId (på engelska), ResourceId |
Parametermängder
SetByResourceGroupId
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter fastighetsnamn: | False |
| Värde från återstående argument: | False |
-Name
Anger namnet på resursgruppen som ska ändras.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokrar: | False |
| DontShow: | False |
| Alias: | ResourceGroupName |
Parametermängder
SetByResourceGroupName
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter fastighetsnamn: | True |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokrar: | False |
| DontShow: | False |
Parametermängder
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter fastighetsnamn: | False |
| Värde från återstående argument: | 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 för 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: @{}.
Parameteregenskaper
| Typ: | Hashtable |
| Standardvärde: | None |
| Stöder jokrar: | False |
| DontShow: | False |
| Alias: | Etiketter |
Parametermängder
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter fastighetsnamn: | True |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.