New-AzureRmDeployment

Riferimento

Modulo:: AzureRM.Resources

Creare una distribuzione

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-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeployment
   [-Name <String>]
   -Location <String>
   [-DeploymentDebugLogLevel <String>]
   [-AsJob]
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzureRmDeployment aggiunge una distribuzione nell'ambito della sottoscrizione corrente. Sono incluse le risorse necessarie per la distribuzione.

Una risorsa di Azure è un'entità di Azure gestita dall'utente. Una risorsa può risiedere in un gruppo di risorse, ad esempio un server di database, un database, un sito Web, una macchina virtuale o un account Archiviazione. In alternativa, può essere una risorsa a livello di sottoscrizione, ad esempio definizione del ruolo, definizione di criteri e così via.

Per aggiungere risorse a un gruppo di risorse, usare New-AzureRmDeployment che crea una distribuzione in un gruppo di risorse. Il cmdlet New-AzureRmDeployment crea una distribuzione nell'ambito della sottoscrizione corrente, che distribuisce le risorse a livello di sottoscrizione.

Per aggiungere una distribuzione in una sottoscrizione, specificare il percorso e un modello. Il percorso indica ad Azure Resource Manager dove archiviare i dati di distribuzione. Il modello è una stringa JSON che contiene singole risorse da distribuire. Il modello include segnaposto dei parametri per le risorse necessarie e valori di proprietà configurabili, ad esempio nomi e dimensioni.

Per usare un modello personalizzato per la distribuzione, specificare il parametro TemplateFile o il parametro TemplateUri . Ogni modello ha parametri per le proprietà configurabili. Per specificare i valori per i parametri del modello, specificare il parametro TemplateParameterFile o il parametro TemplateParameterObject . In alternativa, è possibile usare i parametri del modello aggiunti dinamicamente al comando quando si specifica un modello. Per usare i parametri dinamici, digitarli al prompt dei comandi o digitare un segno meno (-) per indicare un parametro e usare il tasto TAB per scorrere i parametri disponibili. I valori dei parametri del modello immessi al prompt dei comandi hanno la precedenza sui valori in un oggetto parametro modello o in un file.

Esempio

Esempio 1: Usare un modello personalizzato e un file di parametri per creare una distribuzione

PS C:\>New-AzureRmDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -TemplateVersion "2.1"

Questo comando crea una nuova distribuzione nell'ambito della sottoscrizione corrente usando un modello personalizzato e un file modello su disco. Il comando usa il parametro TemplateFile per specificare il modello e il parametro TemplateParameterFile per specificare un file che contiene parametri e valori di parametro. Usa il parametro TemplateVersion per specificare la versione del modello.

Parametri

-ApiVersion

Se impostato, indica la versione dell'API del provider di risorse da usare. Se non specificato, la versione dell'API viene determinata automaticamente come la versione più recente disponibile.

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

-AsJob

Eseguire il cmdlet in background

Type:	SwitchParameter
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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-DeploymentDebugLogLevel

Livello del log di debug della distribuzione.

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

-Location

Percorso in cui archiviare i dati di distribuzione.

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

-Name

Nome della distribuzione che verrà creato. Valido solo quando viene usato un modello. Quando viene usato un modello, se l'utente non specifica un nome di distribuzione, usare l'ora corrente, ad esempio "20131223140835".

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

-Pre

Se impostato, indica che il cmdlet deve usare versioni API non definitive quando si determina automaticamente quale versione usare.

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

-TemplateFile

Percorso locale del file modello.

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

-TemplateParameterFile

File con i parametri del modello.

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

-TemplateParameterObject

Tabella hash che rappresenta i parametri.

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

-TemplateParameterUri

URI al file di parametri del modello.

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

-TemplateUri

Uri del file modello.

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

Input

String

System.Collections.Hashtable

Output

PSDeployment