Condividi tramite

New-AzResourceGroup

Modulo:
Az.Resources Module

Crea un gruppo di risorse di Azure.

Sintassi

Default (impostazione predefinita). 

New-AzResourceGroup
    [-Name] <String>
    [-Location] <String>
    [-Tag <Hashtable>]
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet New-AzResourceGroup 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-AzResource per creare risorse da aggiungere al gruppo di risorse. Per aggiungere una distribuzione a un gruppo di risorse esistente, usare il cmdlet New-AzResourceGroupDeployment. Per aggiungere una risorsa a un gruppo di risorse esistente, usare il cmdlet New-AzResource. 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

New-AzResourceGroup -Name RG01 -Location "South Central US"

Questo comando crea un gruppo di risorse senza risorse. È possibile usare il New-AzResource o New-AzResourceGroupDeployment cmdlet per aggiungere risorse e distribuzioni a questo gruppo di risorse.

Esempio 2: Creare un gruppo di risorse vuoto usando i parametri posizionali

New-AzResourceGroup RG01 "South Central US"

Questo comando crea un gruppo di risorse senza risorse.

Esempio 3: Creare un gruppo di risorse con tag

New-AzResourceGroup -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.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

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

-Force

Forza l'esecuzione del comando senza chiedere conferma dell'utente.

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

-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-AzResourceProvider con il parametro ProviderNamespace.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

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

-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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:NomeGruppoRisorsa

Set di parametri

(All)
Posizione:0
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"} 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-AzResource e Get-AzResourceGroup 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-AzTag.

Proprietà dei parametri

Tipo:Hashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Etichette

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

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

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.

Input

String

Hashtable

Output

PSResourceGroup