你当前正在访问 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,以使用最多六个节点。 每个节点的保留负载为 2 个单位,每个节点上的指标 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 群集资源管理器使用这些指标来管理群集中的资源。 有关 Service Fabric 中的指标和资源管理的详细信息,请参阅 Service Fabric 群集资源管理器简介。 每个指标可以遵循 Pattern 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

指示此操作清除与应用程序容量相关的所有参数。 如果指定此参数,则无法指定 指标 参数来更新应用程序容量。

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