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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.
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.
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Configuration
Gibt den vollständigen Pfad einer CSCFG-Konfigurationsdatei an. Sie können eine Konfigurationsdatei für eine Upgrade- oder Konfigurationsänderung angeben.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionConfiguration
Gibt ein Array von Erweiterungskonfigurationsobjekten an.
Type: | ExtensionConfigurationInput[] |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Gibt an, dass das Cmdlet ein erzwungenes Upgrade durchführt.
Type: | SwitchParameter |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Fortfahren
- Ignorieren
- Fragen
- SilentlyContinue
- Beenden
- Angehalten
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Gibt eine Bezeichnung für die aktualisierte Bereitstellung an.
Type: | String |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mode
Gibt den Modus des Upgrades an. Gültige Werte sind:
- Automatisch
- Manuell
- Gleichzeitige
Type: | String |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewStatus
Gibt den Zielstatus für die Bereitstellung an. Gültige Werte sind: Wird ausgeführt und angehalten.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
Gibt den vollständigen Pfad einer Upgradepaketdatei an.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RoleName
Gibt den Namen der zu aktualisierenden Rolle an.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceName
Gibt den Namen des Azure-Diensts der Bereitstellung an.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Gibt die Umgebung der zu ändernden Bereitstellung an. Gültige Werte sind: Produktion und Staging.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Status
Gibt an, dass dieses Cmdlet den Status der Bereitstellung ändert.
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Upgrade
Gibt an, dass dieses Cmdlet die Bereitstellung aktualisiert.
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |