Start-ServiceFabricClusterUpgrade

模組:

ServiceFabric

升級 Service Fabric 叢集。

Syntax

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Start-ServiceFabricClusterUpgrade Cmdlet 會升級 Service Fabric 叢集。 您可以升級 Service Fabric 程式碼、組態，或同時升級程式碼和組態。

若要管理 Service Fabric 叢集，請使用 [以系統管理員身分執行] 選項啟動Windows PowerShell。 在 Service Fabric 叢集上執行任何作業之前，請先使用 Connect-ServiceFabricCluster Cmdlet 建立叢集的連線。

範例

範例 1：啟動未受監視的手動升級

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "2.0.59.0" -ClusterManifestVersion "v2" -UnmonitoredManual

此命令會針對指定的程式碼套件和組態啟動未受監視的手動升級。

範例 2：僅開始升級程式碼

PS C:\> Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion "2.0.59.0" -UnmonitoredAuto

此命令會啟動指定程式碼套件的未受監視自動升級。 沒有組態升級。

範例 3：僅開始設定升級

Start-ServiceFabricClusterUpgrade -ClusterManifestVersion "v2" -Config -FailureAction Rollback -Monitored

此命令會針對指定的叢集資訊清單版本啟動受監視的組態升級。 升級會使用預設健全狀況原則，並將失敗動作指定為 回復。

範例 4：使用自訂健全狀況原則開始升級

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 20
PS C:\> $svcType.MaxPercentUnhealthyReplicasPerPartition = 20
PS C:\> $warningAsErrorPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $warningAsErrorPolicy.ConsiderWarningAsError = $true
PS C:\> $warningAsErrorPolicy.DefaultServiceTypeHealthPolicy = $svcType

PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $warningAsErrorPolicy)

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "4.2.83.9493" -ClusterManifestVersion "ScaleMin-1.0" -Monitored -FailureAction Rollback -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyNodes 20 -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

此命令會啟動所指定程式碼套件和設定的受監視升級，並傳遞自訂健全狀況原則。 它會指定自訂叢集健全狀況原則，針對重要應用程式類型定義不同的 MaxPercentUnhealthyApplications，以及叢集系統應用程式的自訂應用程式健康情況原則。

參數

-ApplicationHealthPolicyMap

指定 System.Fabric.Health.ApplicationHealthPolicyMap 物件，其中包含部分或所有應用程式的自訂健全狀況原則。 如果您未指定此參數，或如果您未在應用程式的對應中包含專案，則會使用應用程式資訊清單中定義的應用程式健康狀態原則來評估該應用程式，否則會使用預設健全狀況原則來評估該應用程式。

Type:	ApplicationHealthPolicyMap
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeHealthPolicyMap

指定對應，定義每個應用程式類型允許之狀況不良應用程式的最大百分比。 此對應中的應用程式類型是使用特定百分比來評估，而不是 MaxPercentUnhealthyApplications 參數中指定的全域百分比。

例如，如果某個類型的某些應用程式非常重要，叢集系統管理員可以針對該應用程式類型將項目新增至對應，並且為它指派 0% 的值 (也就是不容忍任何失敗)。 所有其他應用程式都可以使用 MaxPercentUnhealthyApplications 參數設定為 20% 來評估，以容許數千個應用程式實例中的某些失敗。

只有在叢集資訊清單使用 HealthManager/EnableApplicationTypeHealthEvaluation的組態專案啟用應用程式類型健康情況評估時，才會使用應用程式類型健康狀態原則對應。

Type:	ApplicationTypeHealthPolicyMap
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterManifestVersion

指定儲存在 Service Fabric 叢集資訊清單中的版本。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Code

表示套件只包含 Service Fabric .msi 檔案。

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CodePackageVersion

指定 Service Fabric .msi 檔案的版本。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Config

表示封裝是 Service Fabric 叢集資訊清單。

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

在執行 Cmdlet 前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsiderWarningAsError

指出是否要在叢集實體和 Nodes 實體的健康情況評估期間，將警告健康情況事件視為錯誤事件。 系統會使用每個應用程式健康情況原則設定來評估應用程式。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableDeltaHealthEvaluation

表示使用差異健康情況評估來判斷 Service Fabric 叢集是否狀況良好。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FailureAction

指定受監視升級失敗時要採取的動作。 此參數可接受的值為：

• 復原
• 手動

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

表示此 Cmdlet 會略過警告訊息，並強制升級。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceRestart

表示即使升級是僅限設定的變更，服務主機仍會重新開機。

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthCheckRetryTimeoutSec

指定持續時間，以秒為單位，之後 Service Fabric 會在先前的健康情況檢查失敗時重試健康情況檢查。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthCheckStableDurationSec

指定 Service Fabric 等候的持續時間，以秒為單位，以確認叢集在移至下一個升級網域或完成升級之前是否穩定。 此等候持續時間可防止在執行健康狀態檢查之後立即偵測到的健康情況變更。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthCheckWaitDurationSec

指定 Service Fabric 在升級網域完成升級之後，于執行初始健康情況檢查之前等候的持續時間，以秒為單位。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCloseDelayDurationSec

指定持續時間，以秒為單位，等待無狀態實例受到叢集升級影響，以允許作用中的要求正常清空。 此等候持續時間僅適用于針對 InstanceCloseDelayDuration 設定非零值的無狀態服務實例，而且會覆寫預先設定的值。 如需詳細資訊 ，請參閱 InstanceCloseDelayDuration 。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPercentDeltaUnhealthyNodes

指定差異狀況不良節點的最大百分比，這些節點可以具有匯總的健康情況狀態錯誤。 如果目前的狀況不良節點未遵守相對於升級開始時狀態的百分比，叢集會被視為狀況不良。

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPercentUnhealthyApplications

指定可具有匯總健全狀況狀態之錯誤的應用程式百分比上限。 如果目前狀況不良的應用程式未遵守此數量，則會將叢集視為狀況不良。

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPercentUnhealthyNodes

指定可具有錯誤匯總健全狀態的節點百分比上限。 如果目前的狀況不良應用程式未遵守此百分比，則叢集會被視為狀況不良。

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

指定升級網域差異狀況不良節點的最大百分比，這些節點可能具有匯總的健康情況狀態錯誤。 如果有任何升級網域，目前的狀況不良節點不會遵守相對於升級開始時狀態的百分比，叢集就會被視為狀況不良。

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Monitored

表示升級模式受到監視。 這表示升級完成升級網域之後，會執行健康情況檢查。 如果升級網域和叢集的健康情況符合指定的健全狀況原則，Service Fabric 就會開始升級下一個升級網域。 如果升級網域或叢集不符合健康情況原則，升級會失敗，而 Service Fabric 會根據指定的 FailureAction回復升級或切換至未受監視的手動模式。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeTypeHealthPolicyMap

針對特定節點類型，定義具有最大百分比狀況不良節點的對應。

節點類型的健康狀態原則對應，可用於在叢集健康狀態評估期間描述特殊的節點類型。 對應中包含的節點類型會根據對應中包含的百分比進行評估，而且全域 (請參閱 System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes) 。 對應中指定的節點類型節點也會計入節點的全域集區;它們是獨立的檢查。

Type:	NodeTypeHealthPolicyMap
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicaQuorumTimeoutSec

指定逾時期間，以秒為單位，以檢查複本集是否有仲裁。 在逾時期間之後，升級會繼續進行。

此參數已被取代。 請改為指定 UpgradeReplicaSetCheckTimeoutSec 參數。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestartProcess

表示服務主機在升級過程中重新開機。

此參數已被取代。 請改為指定 ForceRestart 參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SortOrder

定義升級透過叢集繼續進行的順序。

可能的值包括：

• Invalid - 表示此排序次序無效。 所有 Service Fabric 列舉都有不正確類型。
• Default - 指出將使用叢集資訊清單中指定的預設排序次序 () 。
• Numeric - 表示將使用轉寄數值排序次序 (UD 名稱) 。
• Lexicographical - 表示將使用轉寄語彙排序次序 (UD 名稱) 。
• ReverseNumeric - 表示將使用反向數值排序次序 (UD 名稱) 。
• ReverseLexicographical- 表示將使用反向語彙排序次序， (UD 名稱排序為字串) 。

Type:	UpgradeSortOrder
Accepted values:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

指定作業的逾時期間，以秒為單位。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnmonitoredAuto

表示升級模式為未受監視的自動升級。 在 Service Fabric 升級升級網域之後，不會執行健康情況檢查，不論叢集健全狀況狀態為何，Service Fabric 就會啟動下一個升級網域的升級。 不建議將此模式用於生產環境。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UnmonitoredManual

表示升級模式為未受監視的手動升級。 Service Fabric 升級升級網域之後，它會等候 Resume-ServiceFabricClusterUpgrade Cmdlet 明確啟動下一個升級網域的升級。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeDomainTimeoutSec

指定 Service Fabric 升級單一升級網域所花費的最大時間，以秒為單位。 在此期間之後，升級會失敗。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeReplicaSetCheckTimeoutSec

指定如果尚未處於安全狀態，Service Fabric 等候分割區處於安全狀態的最大時間。 當節點的所有分割區皆通過安全性檢查，Service Fabric 便會於該節點繼續進行升級。

Type:	UInt32
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeTimeoutSec

指定 Service Fabric 在整個升級所花費的最大時間，以秒為單位。 在此期間之後，升級會失敗。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

None

輸出

System.Object

相關連結

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricClusterUpgrade
• Update-ServiceFabricClusterUpgrade
• Resume-ServiceFabricClusterUpgrade
• Remove-ServiceFabricClusterPackage