Condividi tramite

New-AzureDeployment

  • Riferimento
Modulo:
Azure

Crea una distribuzione da un servizio.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Importante

Servizi cloud (versione classica) è ora deprecato per i nuovi clienti e verrà ritirato il 31 agosto 2024 per tutti i clienti. Le nuove distribuzioni devono usare il nuovo modello di distribuzione basato su Azure Resource Manager Azure Servizi cloud (supporto esteso).

Sintassi

New-AzureDeployment
   [-ServiceName] <String>
   [-Package] <String>
   [-Configuration] <String>
   [-Slot] <String>
   [[-Label] <String>]
   [[-Name] <String>]
   [-DoNotStart]
   [-TreatWarningsAsError]
   [-ExtensionConfiguration <ExtensionConfigurationInput[]>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzureDeployment crea una distribuzione di Azure da un servizio che comprende ruoli Web e ruoli di lavoro. Questo cmdlet crea una distribuzione basata su un file di pacchetto (con estensione cspkg) e un file di configurazione del servizio (con estensione cscfg). Specificare un nome univoco all'interno dell'ambiente di distribuzione.

Usare il cmdlet New-AzureVM per creare una distribuzione basata su macchine virtuali di Azure.

Esempio

Esempio 1: Creare una distribuzione

PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Label "ContosoDeployment"

Questo comando crea una distribuzione di produzione basata su un pacchetto denominato ContosoPackage.cspkg e una configurazione denominata ContosoConfiguration.cscfg. Il comando specifica un'etichetta per la distribuzione. Non specifica un nome. Questo cmdlet crea un GUID come nome.

Esempio 2: Creare una distribuzione basata su una configurazione dell'estensione

PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"

Questo comando crea una distribuzione di produzione basata su un pacchetto e una configurazione. Il comando specifica una configurazione di estensione denominata ContosoExtensionConfig.cscfg. Questo cmdlet crea GUID come nome e etichetta.

Parametri

-Configuration

Specifica il percorso completo di un file di configurazione del servizio.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DoNotStart

Specifica che questo cmdlet non avvia la distribuzione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExtensionConfiguration

Specifica una matrice di oggetti di configurazione dell'estensione.

Tipo:ExtensionConfigurationInput[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Label

Specifica un nome di etichetta per la distribuzione. Se non si specifica un'etichetta, questo cmdlet usa un GUID.

Tipo:String
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica un nome di distribuzione. Se non si specifica un nome, questo cmdlet usa un GUID.

Tipo:String
Alias:DeploymentName
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Package

Specifica il percorso o l'URI di un file con estensione cspkg nell'archiviazione all'interno della stessa sottoscrizione o progetto.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceName

Specifica il nome del servizio di Azure per la distribuzione.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Slot

Specifica l'ambiente in cui questo cmdlet crea la distribuzione. I valori validi sono: Staging e Production. Il valore predefinito è Production.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TreatWarningsAsError

Specifica che i messaggi di avviso sono errori. Se si specifica questo parametro, un messaggio di avviso causa l'esito negativo della distribuzione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False