Update-ServiceFabricApplication
更新或移除應用程式容量。
Syntax
Update-ServiceFabricApplication
[-ApplicationName] <Uri>
[-RemoveApplicationCapacity]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Update-ServiceFabricApplication Cmdlet 會更新或移除已建立之應用程式的應用程式容量。
應用程式容量會定義應用程式的最大/最小節點，以及其計量的每個節點容量。
範例
範例 1：更新 MaximumNodes 和 Metrics
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")此命令會更新 application fabric：/MyApp，以使用最多六個節點。 每個節點都有兩個單位的保留負載，每個節點上的 CPU 計量最大負載為 12 個單位。 CPU 計量的應用程式容量總計為 16 單位。 MinimumNodes的值會保持不變。
範例 2：更新 MaximumNodes 和重設計量
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()此命令會更新 application fabric：/MyApp，以使用最多六個節點，並移除所有計量的容量。 如果有任何先前定義的容量，則會在此命令之後清除它們。 MinimumNodes的值未變更。
範例 3：更新所有應用程式容量參數
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")此命令會更新 application fabric：/MyApp，以使用最多六個節點。 每個節點都有兩個單位的保留負載，每個節點上計量 CPU 的最大負載為 12 個單位。 CPU 計量的應用程式容量總計為 16 單位。 最小節點的值會更新為 2，讓 Service Fabric 為叢集中的 CPU 計量保留四個單位的總容量。
範例 4：移除所有應用程式容量參數
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity此命令會更新 application fabric：/MyApp，使其未定義任何應用程式容量參數。 如果 MyApp 有任何先前設定的容量參數，此作業會清除它們。
參數
-ApplicationName
指定要更新的應用程式名稱。
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumNodes
指定要放置應用程式的節點數目上限。 此參數的值必須是非負整數。 預設值為 0，表示應用程式可以放在叢集中任意數目的節點上。
如果您未指定此參數，應用程式會使用為應用程式設定的現有節點數目上限。
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metrics
指定計量的陣列。 Service Fabric 叢集Resource Manager會使用這些計量來管理叢集中的資源。 如需 Service Fabric 中計量和資源管理的詳細資訊，請參閱Service Fabric 叢集Resource Manager簡介。 每個計量都可以遵循 MetricName、NodeReservationCapacity、MaximumNodeCapacity、TotalApplicationCapacity 模式，也可以指定 MetricName 並使用參數名稱 NodeReservationCapacity、MaximumNodeCapacity、TotalApplicationCapacity，後面接著以冒號分隔的參數值。 每個參數 名稱：值 組最多可以出現一次。
- MetricName。 指定計量的名稱。
- NodeReservationCapacity。 指定在具有此應用程式實例的節點上保留的計量負載量。 如果指定 MinimumNodes ，這些值的乘積就是應用程式叢集中保留的容量。
- MaximumNodeCapacity。 指定單一節點上此應用程式實例的最大負載。 即使節點的容量大於此值，Service Fabric 仍會將應用程式子複本的總負載限制為此值。
- TotalApplicationCapacity。 指定叢集中應用程式的總容量。 Service Fabric 會嘗試將應用程式子複本的載入總和限制為此值。
更新容量時，Service Fabric 會執行下列驗證，如果命令未通過，將會失敗：
- NodeReservationCapacity 不能超過 MaximumNodeCapacity。
- 如果同時指定 MinimumNodes 參數和 NodeReservationCapacity 計量， 則 MinimumNodes 和 NodeReservationCapacity 的乘積不能超過 TotalApplicationCapacity。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumNodes
指定叢集中保留容量給此應用程式的節點數目，這並不表示應用程式保證在所有這些節點上都有複本。 此參數的值必須是非負整數。 這個 的預設值為零，這表示不會保留任何容量給應用程式。
如果 MinimumNodes 設定為 0，則不會保留容量。
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveApplicationCapacity
表示此作業會清除與應用程式容量相關的所有參數。 如果您指定此參數，就無法指定 Metrics 參數來更新應用程式容量。
| Type: | SwitchParameter |
| Position: | Named |
| 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 |
輸入
None
輸出
System.Object