New-AzureDeployment
Erstellt eine Bereitstellung aus einem Dienst.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
Wichtig
Cloud Services (klassisch) wurde für neue Kunden nun als veraltet gekennzeichnet und wird am 31. August 2024 für alle Kunden ausgemustert. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.
Syntax
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>]
Beschreibung
Das Cmdlet New-AzureDeployment erstellt eine Azure-Bereitstellung aus einem Dienst, der Webrollen und Workerrollen umfasst. Dieses Cmdlet erstellt eine Bereitstellung basierend auf einer Paketdatei (.cspkg) und einer Dienstkonfigurationsdatei (CSCFG). Geben Sie einen Namen an, der innerhalb der Bereitstellungsumgebung eindeutig ist.
Verwenden Sie das Cmdlet "New-AzureVM ", um eine Bereitstellung basierend auf virtuellen Azure-Computern zu erstellen.
Beispiele
Beispiel 1: Erstellen einer Bereitstellung
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"
Mit diesem Befehl wird eine Produktionsbereitstellung basierend auf einem Paket namens ContosoPackage.cspkg und einer Konfiguration namens ContosoConfiguration.cscfg erstellt. Der Befehl gibt eine Bezeichnung für die Bereitstellung an. Es gibt keinen Namen an. Mit diesem Cmdlet wird eine GUID als Name erstellt.
Beispiel 2: Erstellen einer Bereitstellung basierend auf einer Erweiterungskonfiguration
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"
Dieser Befehl erstellt eine Produktionsbereitstellung basierend auf einem Paket und einer Konfiguration. Der Befehl gibt eine Erweiterungskonfiguration namens ContosoExtensionConfig.cscfg an. Mit diesem Cmdlet werden GUIDs als Name und Bezeichnung erstellt.
Parameter
-Configuration
Gibt den vollständigen Pfad einer Dienstkonfigurationsdatei an.
Typ: | String |
Position: | 2 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DoNotStart
Gibt an, dass dieses Cmdlet die Bereitstellung nicht startet.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExtensionConfiguration
Gibt ein Array von Erweiterungskonfigurationsobjekten an.
Typ: | ExtensionConfigurationInput[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Weiter
- Ignorieren
- Inquire
- SilentlyContinue
- Beenden
- Angehalten
Typ: | ActionPreference |
Aliase: | infa |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Typ: | String |
Aliase: | iv |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Label
Gibt einen Bezeichnungsnamen für die Bereitstellung an. Wenn Sie keine Bezeichnung angeben, verwendet dieses Cmdlet eine GUID.
Typ: | String |
Position: | 4 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen Bereitstellungsnamen an. Wenn Sie keinen Namen angeben, verwendet dieses Cmdlet eine GUID.
Typ: | String |
Aliase: | DeploymentName |
Position: | 5 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Package
Gibt den Pfad oder URI einer CSPKG-Datei im Speicher innerhalb desselben Abonnements oder Projekts an.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Typ: | AzureSMProfile |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ServiceName
Gibt den Namen des Azure-Diensts für die Bereitstellung an.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Slot
Gibt die Umgebung an, in der dieses Cmdlet die Bereitstellung erstellt. Gültige Werte sind: Staging und Produktion. Der Standardwert ist Production.
Typ: | String |
Position: | 3 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-TreatWarningsAsError
Gibt an, dass Warnmeldungen Fehler sind. Wenn Sie diesen Parameter angeben, führt eine Warnmeldung dazu, dass die Bereitstellung fehlschlägt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |