New-AzureRmResourceGroup
Crea un gruppo di risorse di Azure.
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
New-AzureRmResourceGroup
-Name <String>
-Location <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-AzureRmResourceGroup crea un gruppo di risorse di Azure. È possibile creare un gruppo di risorse usando solo un nome e una posizione e quindi usare il cmdlet New-AzureRmResource per creare risorse da aggiungere al gruppo di risorse. Per aggiungere una distribuzione a un gruppo di risorse esistente, usare il cmdlet New-AzureRmResourceGroupDeployment. Per aggiungere una risorsa a un gruppo di risorse esistente, usare il cmdlet New-AzureRmResource . Una risorsa di Azure è un'entità di Azure gestita dall'utente, ad esempio un server di database, un database o un sito Web. Un gruppo di risorse di Azure è una raccolta di risorse di Azure distribuite come unità.
Esempio
Esempio 1: Creare un gruppo di risorse vuoto
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"Questo comando crea un gruppo di risorse senza risorse. È possibile usare i cmdlet New-AzureRmResource o New-AzureRmResourceGroupDeployment per aggiungere risorse e distribuzioni a questo gruppo di risorse.
Esempio 2: Creare un gruppo di risorse vuoto usando i parametri posizionali
PS> New-AzureRmResourceGroup RG01 "South Central US"Questo comando crea un gruppo di risorse senza risorse.
Esempio 3: Creare un gruppo di risorse con tag
PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}Questo comando crea un gruppo di risorse vuoto. Questo comando è uguale al comando nell'esempio 1, ad eccezione del fatto che assegna tag al gruppo di risorse. Il primo tag, denominato Empty, può essere usato per identificare i gruppi di risorse che non dispongono di risorse. Il secondo tag è denominato Department e ha il valore Marketing. È possibile usare un tag come questo per classificare i gruppi di risorse per l'amministrazione o il budget.
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 |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| 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 |
-Force
Forza l'esecuzione del comando senza chiedere conferma all'utente.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Location
Specifica la posizione del gruppo di risorse. Specificare una posizione del data center di Azure, ad esempio Stati Uniti occidentali o Asia sud-orientale. È possibile inserire un gruppo di risorse in qualsiasi posizione. Il gruppo di risorse non deve trovarsi nella stessa posizione della sottoscrizione di Azure o nella stessa posizione delle risorse. Per determinare il percorso che supporta ogni tipo di risorsa, usare il cmdlet Get-AzureRmResourceProvider con il parametro ProviderNamespace .
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Specifica un nome per il gruppo di risorse. Il nome della risorsa deve essere univoco nella sottoscrizione. Se esiste già un gruppo di risorse con tale nome, il comando chiede conferma prima di sostituire il gruppo di risorse esistente.
| Tipo: | String |
| Alias: | ResourceGroupName |
| Posizione: | Named |
| 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"} Per aggiungere o modificare un tag, è necessario sostituire la raccolta di tag per il gruppo 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 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 ottenere i tag predefiniti, usare il cmdlet Get-AzureRMTag.
| Tipo: | Hashtable |
| Alias: | Tags |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
None
Output
Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup