Condividi tramite

Set-AzureRmResourceGroup

  • Riferimento
Modulo:
AzureRM.Resources

Modifica un gruppo di risorse.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureRmResourceGroup
   [-Name] <String>
   [-Tag] <Hashtable>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmResourceGroup
   [-Tag] <Hashtable>
   [-Id] <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureRmResourceGroup modifica le proprietà di un gruppo di risorse. È possibile usare questo cmdlet per aggiungere, modificare o eliminare i tag di Azure applicati a un gruppo di risorse. Specificare il parametro Name per identificare il gruppo di risorse e il parametro Tag per modificare i tag. Non è possibile usare questo cmdlet per modificare il nome di un gruppo di risorse.

Esempio

Esempio 1: Applicare un tag a un gruppo di risorse

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Questo comando applica un tag Reparto con un valore IT a un gruppo di risorse senza tag esistenti.

Esempio 2: Aggiungere tag a un gruppo di risorse

PS C:\>$Tags = (Get-AzureRmResourceGroup -Name "ContosoRG").Tags
PS C:\> $Tags
PS C:\> $Tags += @{"Status"="Approved"; "FY2016"=$null}
PS C:\> Set-AzureRmResourceGroup -Name "ContosoRG" -Tag $Tags
PS C:> (Get-AzureRmResourceGroup -Name "ContosoRG").Tags

In questo esempio viene aggiunto un tag Status con un valore Approvato e un tag FY2016 a un gruppo di risorse con tag esistenti. Poiché i tag specificati sostituiscono i tag esistenti, è necessario includere i tag esistenti nella nuova raccolta di tag o perderli. Il primo comando ottiene il gruppo di risorse ContosoRG e usa il metodo dot per ottenere il valore della relativa proprietà Tags. Il comando archivia i tag nella variabile $Tags. Il secondo comando ottiene i tag nella variabile $Tags. Il terzo comando usa l'operatore di assegnazione += per aggiungere i tag Status e FY2016 alla matrice di tag nella variabile $Tags. Il quarto comando usa il parametro Tag di Set-AzureRmResourceGroup per applicare i tag nella variabile $Tags al gruppo di risorse ContosoRG. Il quinto comando ottiene tutti i tag applicati al gruppo di risorse ContosoRG. L'output mostra che il gruppo di risorse ha il tag Department e i due nuovi tag, Status e FY2015.

Esempio 3: Eliminare tutti i tag per un gruppo di risorse

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{}

Questo comando specifica il parametro Tag con un valore di tabella hash vuoto per eliminare tutti i tag dal gruppo di risorse ContosoRG.

Parametri

-ApiVersion

Specifica la versione dell'API supportata dal provider di risorse. È possibile specificare una versione diversa rispetto alla versione predefinita.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica l'ID del gruppo di risorse da modificare.

Tipo:String
Alias:ResourceGroupId, ResourceId
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome del gruppo di risorse da modificare.

Tipo:String
Alias:ResourceGroupName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"} Un tag è una coppia nome-valore che è possibile creare e applicare a risorse e gruppi di risorse. Dopo aver assegnato tag a risorse e gruppi, è possibile usare il parametro Tag di Get-AzureRmResource e Get-AzureRmResourceGroup per cercare risorse e gruppi in base al nome o al nome e al valore del tag. È possibile usare i tag per classificare le risorse, ad esempio per reparto o centro di costo, o per tenere traccia di note o commenti sulle risorse. Per aggiungere o modificare un tag, è necessario sostituire la raccolta di tag per il gruppo di risorse. Per eliminare un tag, immettere una tabella hash con tutti i tag attualmente applicati al gruppo di risorse, da Get-AzureRmResourceGroup, ad eccezione del tag da eliminare. Per eliminare tutti i tag da un gruppo di risorse, specificare una tabella hash vuota: @{}.

Tipo:Hashtable
Alias:Tags
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

None

Output

Microsoft.Azure.Commands.Resources.Models.PSResourceGroup