Set-AzResourceGroup
Modifica un gruppo di risorse.
Sintassi
SetByResourceGroupName (Impostazione predefinita)
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>]
Descrizione
Il cmdlet Set-AzResourceGroup 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
Set-AzResourceGroup -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
$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -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-AzResourceGroup 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
Set-AzResourceGroup -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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
Proprietà dei parametri
| Tipo: | IAzureContextContainer |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Id
Specifica l'ID del gruppo di risorse da modificare.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ResourceGroupId, ResourceId |
Set di parametri
SetByResourceGroupId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica il nome del gruppo di risorse da modificare.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ResourceGroupName |
Set di parametri
SetByResourceGroupName
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Pre
Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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-AzResource e Get-AzResourceGroup 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-AzResourceGroup, ad eccezione del tag da eliminare. Per eliminare tutti i tag da un gruppo di risorse, specificare una tabella hash vuota: @{}.
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Etichette |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
