Update-ServiceFabricApplicationUpgrade
Ändrar uppgraderingsbeskrivningen för en aktiv programuppgradering.
Syntax
Update-ServiceFabricApplicationUpgrade
[-ApplicationName] <Uri>
[-ForceRestart <Boolean>]
[-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
[-UpgradeMode <RollingUpgradeMode>]
[-FailureAction <UpgradeFailureAction>]
[-HealthCheckRetryTimeoutSec <UInt32>]
[-HealthCheckWaitDurationSec <UInt32>]
[-HealthCheckStableDurationSec <UInt32>]
[-UpgradeDomainTimeoutSec <UInt32>]
[-UpgradeTimeoutSec <UInt32>]
[-ConsiderWarningAsError <Boolean>]
[-DefaultServiceTypeHealthPolicy <String>]
[-MaxPercentUnhealthyDeployedApplications <Byte>]
[-ServiceTypeHealthPolicyMap <Hashtable>]
[-Force]
[-InstanceCloseDelayDurationSec <UInt32>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Cmdleten Update-ServiceFabricApplicationUpgrade ändrar parametrarna för en programuppgraderingsbeskrivning medan uppgraderingen fortfarande är aktiv. Service Fabric identifierar och tillämpar ändringar enligt upgradeStatusPollInterval-värdet , enligt vad som anges i klustermanifestet. Förutom hälsoutvärderingsprinciper uppdaterar denna cmdlet endast de parametrar som du anger. Ospecificerade parametrar påverkas inte. Du måste uppdatera följande hälsoutvärderingsprinciper tillsammans, inte individuellt:
- ConsiderWarningAsError
- DefaultServiceTypeHealthPolicy
- MaxPercentUnhealthyDeployedApplications
- ServiceTypeHealthPolicyMap
Innan du utför en åtgärd på ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .
Exempel
Exempel 1: Uppdatera ett värde för en programuppgradering
PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0Det här kommandot anger timeout-värdet för replikuppsättningen till 0 för en väntande uppgradering av infrastrukturresurser:/MyApplication. Uppdateringen lämnar alla andra uppgraderingsvärden ensamma.
Parametrar
-ApplicationName
Anger URI (Uniform Resource Identifier) för ett Service Fabric-program. Cmdleten uppdaterar inställningarna för uppgraderingen för det program som har den URI som den här parametern anger.
| Typ: | Uri |
| Position: | 0 |
| 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: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ConsiderWarningAsError
Anger om en varningshälsorapport ska behandlas som ett fel under hälsoutvärderingen.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DefaultServiceTypeHealthPolicy
Anger standardhälsoprincipen för tjänsttyper. Hälsoprincipen används för den övervakade uppgraderingen. Principen följer 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 |
-FailureAction
Anger vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De acceptabla värdena för den här parametern är:
- Återställning
- Manuell
| Typ: | UpgradeFailureAction |
| Godkända värden: | Invalid, Rollback, Manual |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Force
Anger att denna cmdlet hoppar över varningsmeddelandet och tvingar uppdateringen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ForceRestart
Anger om tjänstvärden startas om även om uppgraderingen är en konfigurationsändring.
| Typ: | Boolean |
| Position: | Named |
| 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 verifiera att programmet är stabilt innan det fortsätter 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 |
-InstanceCloseDelayDurationSec
Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av programuppgraderingen stängs, så att de aktiva begärandena kan tömmas korrekt. Den här väntetiden gäller endast för instanser av tillståndslösa tjänster som har ett värde som inte är noll konfigurerat för InstanceCloseDelayDuration och åsidosätter det förkonfigurerade värdet. Mer information finns i InstanceCloseDelayDuration .
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaxPercentUnhealthyDeployedApplications
Anger den maximala procentandelen av tolererade distribuerade program som kan ha ett feltillstånd. Om procentandelen programinstanser med feltillstånd som distribueras på noderna i klustret överskrider det värde som anges i den här parametern är programmets hälsotillstånd ett fel.
| Typ: | Byte |
| Position: | Named |
| 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. Ange kartan 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 |
-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 |
-UpgradeMode
Anger den nya UpgradeMode för uppgraderingen.
| Typ: | RollingUpgradeMode |
| Godkända värden: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeReplicaSetCheckTimeoutSec
Anger den maximala tiden i sekunder som Service Fabric väntar på att en tjänst ska konfigureras om till ett säkert tillstånd, om det inte redan är i ett säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.
| Typ: | UInt32 |
| Position: | Named |
| 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ördes. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
None
Utdata
System.Object