你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Update-ServiceFabricApplication
更新或删除应用程序容量。
语法
Update-ServiceFabricApplication
[-ApplicationName] <Uri>
[-RemoveApplicationCapacity]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
说明
Update-ServiceFabricApplication cmdlet 更新或删除已创建的应用程序的应用程序容量。
应用程序容量定义应用程序的最大/最小节点,以及其指标的每个节点的容量。
示例
示例 1:更新 MaximumNodes 和指标
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
指定要更新的应用程序的名称。
类型: | Uri |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-MaximumNodes
指定要放置应用程序的最大节点数。 此参数的值必须是非负整数。 默认值为 0,指示应用程序可以放置在群集中任意数量的节点上。
如果未指定此参数,应用程序将使用为应用程序设置的现有最大节点数。
类型: | Int64 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Metrics
指定指标数组。 Service Fabric 群集资源管理器使用这些指标来管理群集中的资源。 有关 Service Fabric 中的指标和资源管理的详细信息,请参阅 Service Fabric 群集资源管理器简介。 每个指标可以遵循 Pattern MetricName、NodeReservationCapacity、MaximumNodeCapacity、TotalApplicationCapacity,或者可以指定 MetricName 并使用参数名称 NodeReservationCapacity、MaximumNodeCapacity、TotalApplicationCapacity,后跟用冒号分隔的参数值。 每个参数 name:value 对最多可以显示一次。
- MetricName。 指定指标的名称。
- NodeReservationCapacity。 指定在此应用程序的实例的节点上保留的指标负载量。 如果指定 MinimumNodes,则这些值的乘积是应用程序群集中保留的容量。
- MaximumNodeCapacity。 指定单个节点上此应用程序的实例的最大负载。 即使节点的容量大于此值,Service Fabric 也会将应用程序的子副本的总负载限制为此值。
- TotalApplicationCapacity。 指定群集中应用程序的总容量。 Service Fabric 尝试将应用程序的子副本负载之和限制为此值。
更新容量时,Service Fabric 会执行以下验证,如果命令未通过,它将失败:
- NodeReservationCapacity 不能超过 MaximumNodeCapacity。
- 如果同时指定了 MinimumNodes 参数和 NodeReservationCapacity 指标,则 MinimumNodes 和 NodeReservationCapacity 的乘积不能超过 TotalApplicationCapacity。
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MinimumNodes
指定为此应用程序保留容量的群集中的节点数,这并不意味着应用程序保证在所有这些节点上具有副本。 此参数的值必须是非负整数。 默认值为零,这意味着没有为应用程序保留容量。
如果 MinimumNodes 设置为 0,则不保留容量。
类型: | Int64 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-RemoveApplicationCapacity
指示此操作清除与应用程序容量相关的所有参数。 如果指定此参数,则无法指定 指标 参数来更新应用程序容量。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TimeoutSec
指定操作的超时期限(以秒为单位)。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
System.Object