Set-AzureDeployment
Ändrar status, konfigurationsinställningar eller uppgraderingsläge för en distribution.
Kommentar
De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.
Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.
Viktigt!
Cloud Services (klassisk) är nu inaktuellt för nya kunder och kommer att dras tillbaka den 31 augusti 2024 för alla kunder. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).
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>] Description
Cmdleten Set-AzureDeployment ändrar status, konfigurationsinställningar eller uppgraderingsläget för en Azure-distribution. Du kan ändra status för distributionen till Antingen Körs eller Pausas. Du kan ändra cscfg-filen för distributionen. Du kan ange uppgraderingsläget och uppdatera konfigurationsfilerna. Använd cmdleten Set-AzureWalkUpgradeDomain för att initiera en uppgradering.
Exempel
Exempel 1: Ändra status för en distribution
PS C:\> Set-AzureDeployment -Status -ServiceName "ContosoService" -Slot "Production" -NewStatus "Running"Det här kommandot anger status för distributionen för tjänsten med namnet ContosoService i produktionsmiljön till Körs.
Exempel 2: Tilldela en annan konfigurationsfil till en distribution
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Slot "Staging" -Configuration "C:\Temp\MyServiceConfig.Cloud.csfg"Det här kommandot tilldelar en annan konfigurationsfil för distributionen för tjänsten med namnet ContosoService i mellanlagringsmiljön.
Exempel 3: Ställ in uppgraderingsläget på Auto
PS C:\> Set-AzureDeployment -Upgrade -ServiceName "ContosoService" -Mode Auto -Package "C:\packages\ContosoApp.cspkg" -Configuration "C:\Config\ContosoServiceConfig.Cloud.csfg"Det här kommandot anger uppgraderingsläget till Auto och anger ett uppgraderingspaket och en ny konfigurationsfil.
Exempel 4: Installera tilläggskonfiguration i en tjänst
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"Det här kommandot installerar tilläggskonfigurationen i den angivna molntjänsten och tillämpar dem på roller.
Parametrar
-Config
Anger att den här cmdleten ändrar konfigurationen av distributionen.
| Typ: | SwitchParameter |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Configuration
Anger den fullständiga sökvägen till en .cscfg-konfigurationsfil. Du kan ange en konfigurationsfil för en uppgradering eller konfigurationsändring.
| Typ: | String |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ExtensionConfiguration
Anger en matris med tilläggskonfigurationsobjekt.
| Typ: | ExtensionConfigurationInput[] |
| Position: | 9 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Force
Anger att cmdleten utför en tvingad uppgradering.
| Typ: | SwitchParameter |
| Position: | 8 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-InformationAction
Anger hur den här cmdleten svarar på en informationshändelse.
De acceptabla värdena för den här parametern är:
- Fortsätt
- Ignorera
- Fråga
- TystKontinuera
- Stoppa
- Suspend
| Typ: | ActionPreference |
| Alias: | infa |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-InformationVariable
Anger en informationsvariabel.
| Typ: | String |
| Alias: | iv |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Label
Anger en etikett för den uppgraderade distributionen.
| Typ: | String |
| Position: | 6 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Mode
Anger uppgraderingsläget. Giltiga värden är:
- Automatisk
- Manuell
- Samtidig
| Typ: | String |
| Position: | 5 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-NewStatus
Anger målstatus för distributionen. Giltiga värden är: Körs och pausas.
| Typ: | String |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Package
Anger den fullständiga sökvägen för en uppgraderingspaketfil.
| Typ: | String |
| Position: | 2 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Profile
Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-RoleName
Anger namnet på rollen som ska uppgraderas.
| Typ: | String |
| Position: | 7 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ServiceName
Anger namnet på Azure-tjänsten för distributionen.
| Typ: | String |
| Position: | 1 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Slot
Anger den miljö för distributionen som ska ändras. Giltiga värden är: Produktion och mellanlagring.
| Typ: | String |
| Position: | 4 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Status
Anger att den här cmdleten ändrar distributionens status.
| Typ: | SwitchParameter |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Upgrade
Anger att den här cmdleten uppgraderar distributionen.
| Typ: | SwitchParameter |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |