Start-ServiceFabricComposeDeploymentUpgrade
FÖRHANDSVISNING. Uppgraderar en Service Fabric-sammansättningsdistribution med en ny skrivfil.
Syntax
Start-ServiceFabricComposeDeploymentUpgrade
[-DeploymentName] <String>
[-Compose] <String>
[[-RegistryUserName] <String>]
[[-RegistryPassword] <String>]
[-PasswordEncrypted]
[-ForceRestart]
[[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
[-UnmonitoredAuto]
[-Force]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-ServiceFabricComposeDeploymentUpgrade
[-DeploymentName] <String>
[-Compose] <String>
[[-RegistryUserName] <String>]
[[-RegistryPassword] <String>]
[-PasswordEncrypted]
[-ForceRestart]
[[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
[-UnmonitoredManual]
[-Force]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-ServiceFabricComposeDeploymentUpgrade
[-DeploymentName] <String>
[-Compose] <String>
[[-RegistryUserName] <String>]
[[-RegistryPassword] <String>]
[-PasswordEncrypted]
[-ForceRestart]
[[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
[-Monitored]
-FailureAction <UpgradeFailureAction>
[-HealthCheckRetryTimeoutSec <UInt32>]
[-HealthCheckWaitDurationSec <UInt32>]
[-HealthCheckStableDurationSec <UInt32>]
[-UpgradeDomainTimeoutSec <UInt32>]
[-UpgradeTimeoutSec <UInt32>]
[-ConsiderWarningAsError <Boolean>]
[-DefaultServiceTypeHealthPolicy <String>]
[-MaxPercentUnhealthyDeployedApplications <Byte>]
[-ServiceTypeHealthPolicyMap <Hashtable>]
[-Force]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Den här cmdleten är i förhandsversion och kan komma att ändras i nästa version. Det finns ingen kompatibilitetsgaranti.
Cmdleten Start-ServiceFabricComposeDeploymentUpgrade uppgraderar en Service Fabric Compose-distribution. Den här cmdleten startar uppgraderingen av klustret.
Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster.
Vägledning för distribution av Service Fabric Compose finns i: Compose-distribution i Service Fabric
Exempel
Exempel 1: Uppgradera en skrivdistribution
PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction RollbackKommandot utför en övervakad automatisk uppgradering vid skrivdistribution med namnet mydeployment från skrivfil docker-compose.yml. Uppgraderingen återställs om den övervakade uppgraderingen misslyckas. Du behöver inte registrera programtypen i förväg.
Parametrar
-Compose
Anger filsökvägen till en måluppsättningsfil som beskriver distributionen av Service Fabric Compose.
| Typ: | String |
| Position: | 1 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ConsiderWarningAsError
Anger om en varningshälsohändelse ska behandlas som en felhändelse under hälsoutvärderingen.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DefaultServiceTypeHealthPolicy
Anger hälsoprincipen för standardtjänsttypen som ska användas för den övervakade uppgraderingen i formatet MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Till exempel anger 5,10,15 följande värden:
- MaxPercentUnhealthyPartitionsPerService = 5
- MaxPercentUnhealthyReplicasPerPartition = 10
- MaxPercentUnhealthyServices = 15
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DeploymentName
Anger namnet på sammansättningsdistributionen. Cmdleten uppgraderar skrivdistributionen med det här namnet.
| Typ: | String |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-FailureAction
Anger vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De godtagbara värdena för den här parametern är:
- Ångring
- Handbok
| Typ: | UpgradeFailureAction |
| Godkända värden: | Invalid, Rollback, Manual |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Force
Anger att denna cmdlet hoppar över varningsmeddelandet och tvingar uppgraderingen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ForceRestart
Anger att alla containrar i skrivfilen ska återskapas även om tjänstbeskrivningarna inte ändrades i den nya skrivfilen.
| Typ: | SwitchParameter |
| Position: | 5 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-HealthCheckRetryTimeoutSec
Anger varaktigheten, i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den tidigare hälsokontrollen misslyckas.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-HealthCheckStableDurationSec
Anger varaktigheten i sekunder som Service Fabric väntar för att kontrollera att programmet som utgör distributionen som distribueras är stabilt innan det flyttas till nästa uppgraderingsdomän eller slutför uppgraderingen. Den här väntetiden förhindrar oupptäckta hälsoändringar direkt efter att hälsokontrollen har utförts.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-HealthCheckWaitDurationSec
Anger varaktigheten, i sekunder, som Service Fabric väntar innan den utför den första hälsokontrollen när uppgraderingen har slutförts på uppgraderingsdomänen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaxPercentUnhealthyDeployedApplications
Anger den maximala procentandelen av de programinstanser som distribueras på noderna i klustret som har ett feltillstånd innan programmets hälsotillstånd för klustret är fel.
| Typ: | Byte |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Monitored
Anger att uppgraderingsläget övervakas. När cmdleten har slutfört en uppgradering för en uppgraderingsdomän, uppgraderar Service Fabric nästa uppgraderingsdomän om uppgraderingsdomänens och klustrets hälsotillstånd uppfyller de hälsoprinciper som du definierar. Om uppgraderingsdomänen eller klustret inte uppfyller hälsoprinciperna misslyckas uppgraderingen och Service Fabric återställer uppgraderingen för uppgraderingsdomänen eller återgår till manuellt läge enligt den angivna principen. Det här är det rekommenderade läget för att skapa distributionsuppgraderingar i en produktionsmiljö.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-PasswordEncrypted
Anger om RegistryPassword krypteras av Invoke-ServiceFabricEncryptText.
| Typ: | SwitchParameter |
| Position: | 4 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-RegistryPassword
Anger lösenordet för containerregistret. Om den här parmametern tillhandahålls måste RegistryUserName anges tillsammans.
| Typ: | String |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-RegistryUserName
Anger användarnamnet för containerregistret. Om den här parmametern tillhandahålls måste RegistryPassword anges tillsammans.
| Typ: | String |
| Position: | 2 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ServiceTypeHealthPolicyMap
Anger kartan över hälsoprincipen som ska användas för olika tjänsttyper som en hash-tabell i följande format: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Till exempel:
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
| Typ: | Hashtable |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TimeoutSec
Anger tidsgränsen i sekunder för åtgärden.
| Typ: | Int32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UnmonitoredAuto
Anger att uppgraderingsläget är oövervakat automatiskt. När Service Fabric har uppgraderat en uppgraderingsdomän uppgraderar Service Fabric nästa uppgraderingsdomän oavsett programmets hälsotillstånd. Det här läget rekommenderas inte för produktion och är bara användbart under utvecklingen av en sammansättningsdistribution.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UnmonitoredManual
Anger att uppgraderingsläget är oövervakat manuellt. När Service Fabric har uppgraderat en uppgraderingsdomän väntar den på att du uppgraderar nästa uppgraderingsdomän med hjälp av cmdleten Resume-ServiceFabricApplicationUpgrade.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeDomainTimeoutSec
Anger den maximala tid i sekunder som Service Fabric tar att uppgradera en enda uppgraderingsdomän. Efter den här perioden misslyckas uppgraderingen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeReplicaSetCheckTimeoutSec
Anger den maximala tid som Service Fabric väntar på att en tjänst ska konfigureras om till ett säkert tillstånd, om inte redan i säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.
| Typ: | UInt32 |
| Position: | 6 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeTimeoutSec
Anger den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
None
Utdata
System.Object