New-AzResourceGroup

  • Riferimento
Modulo:
Az.Resources

Crea un gruppo di risorse di Azure.

Sintassi

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 i cmdlet New-AzResource o New-AzResourceGroupDeployment 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Hashtable

Output

PSResourceGroup