Set-AzureDeployment
Ändert den Status, die Konfigurationseinstellungen oder den Upgrademodus einer Bereitstellung.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-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
Set-AzureDeployment
[-Upgrade]
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Mode] <String>]
[[-Label] <String>]
[[-RoleName] <String>]
[-Force]
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Config]
[-ServiceName] <String>
[-Configuration] <String>
[-Slot] <String>
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Status]
[-ServiceName] <String>
[-Slot] <String>
[-NewStatus] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-AzureDeployment ändert den Status, die Konfigurationseinstellungen oder den Upgrademodus einer Azure-Bereitstellung. Sie können den Status der Bereitstellung entweder in "Ausführen" oder "Angehalten" ändern. Sie können die CSCFG-Datei für die Bereitstellung ändern. Sie können den Upgrademodus festlegen und Konfigurationsdateien aktualisieren. Verwenden Sie das Cmdlet Set-AzureWalkUpgradeDomain , um ein Upgrade zu initiieren.
Beispiele
Beispiel 1: Ändern des Status einer Bereitstellung
PS C:\> Set-AzureDeployment -Status -ServiceName "ContosoService" -Slot "Production" -NewStatus "Running"Mit diesem Befehl wird der Status der Bereitstellung für den Dienst "ContosoService" in der Produktionsumgebung auf "Running" festgelegt.
Beispiel 2: Zuweisen einer anderen Konfigurationsdatei zu einer Bereitstellung
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Slot "Staging" -Configuration "C:\Temp\MyServiceConfig.Cloud.csfg"Mit diesem Befehl wird eine andere Konfigurationsdatei für die Bereitstellung des Diensts "ContosoService" in der Stagingumgebung zugewiesen.
Beispiel 3: Festlegen des Upgrademodus auf "Automatisch"
PS C:\> Set-AzureDeployment -Upgrade -ServiceName "ContosoService" -Mode Auto -Package "C:\packages\ContosoApp.cspkg" -Configuration "C:\Config\ContosoServiceConfig.Cloud.csfg"Mit diesem Befehl wird der Upgrademodus auf "Automatisch" festgelegt und ein Upgradepaket und eine neue Konfigurationsdatei angegeben.
Beispiel 4: Installieren der Erweiterungskonfiguration in einem Dienst
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Mode "Automatic" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Slot "Production" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"Mit diesem Befehl wird die Erweiterungskonfiguration im angegebenen Clouddienst installiert und auf Rollen angewendet.
Parameter
-Config
Gibt an, dass dieses Cmdlet die Konfiguration der Bereitstellung ändert.
| Typ: | SwitchParameter |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Configuration
Gibt den vollständigen Pfad einer CSCFG-Konfigurationsdatei an. Sie können eine Konfigurationsdatei für eine Upgrade- oder Konfigurationsänderung angeben.
| Typ: | String |
| Position: | 3 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ExtensionConfiguration
Gibt ein Array von Erweiterungskonfigurationsobjekten an.
| Typ: | ExtensionConfigurationInput[] |
| Position: | 9 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Force
Gibt an, dass das Cmdlet ein erzwungenes Upgrade durchführt.
| Typ: | SwitchParameter |
| Position: | 8 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Fortsetzen
- 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 eine Bezeichnung für die aktualisierte Bereitstellung an.
| Typ: | String |
| Position: | 6 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Mode
Gibt den Modus des Upgrades an. Gültige Werte sind:
- Automatisch
- Manuell
- Gleichzeitig
| Typ: | String |
| Position: | 5 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NewStatus
Gibt den Zielstatus für die Bereitstellung an. Gültige Werte sind: Wird ausgeführt und angehalten.
| Typ: | String |
| Position: | 3 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Package
Gibt den vollständigen Pfad einer Upgradepaketdatei an.
| Typ: | String |
| Position: | 2 |
| 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 |
-RoleName
Gibt den Namen der zu aktualisierenden Rolle an.
| Typ: | String |
| Position: | 7 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ServiceName
Gibt den Namen des Azure-Diensts der Bereitstellung an.
| Typ: | String |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Slot
Gibt die Umgebung der zu ändernden Bereitstellung an. Gültige Werte sind: Produktion und Staging.
| Typ: | String |
| Position: | 4 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Status
Gibt an, dass dieses Cmdlet den Status der Bereitstellung ändert.
| Typ: | SwitchParameter |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Upgrade
Gibt an, dass dieses Cmdlet die Bereitstellung aktualisiert.
| Typ: | SwitchParameter |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |