你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-ServiceFabricApplication

  • 参考
模块:
ServiceFabric

创建 Service Fabric 应用程序。

语法

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

说明

New-ServiceFabricApplication cmdlet 创建已注册应用程序类型的 Service Fabric 应用程序。 使用 Register-ServiceFabricApplicationType cmdlet 注册应用程序类型。

在 Service Fabric 群集上执行任何操作之前，请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。

示例

示例 1：创建应用程序

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

此命令创建 PersistentToDoListApp 类型的应用程序。 应用程序为版本 1.0。 应用程序类型和版本来自使用 Register-ServiceFabricApplicationType cmdlet 注册应用程序时使用的应用程序包中的应用程序清单。

示例 2：通过在应用程序清单中重写默认参数值来创建应用程序

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

此命令为 Parameters CustomParameter1 和 CustomParameter2 创建类型 PersistentToDoListApp 和版本 1.0 的应用程序，并重写了参数 CustomParameter1 和 CustomParameter2 的值。 这些参数名称必须存在于使用 Register-ServiceFabricApplicationType cmdlet 注册应用程序时使用的应用程序包的应用程序清单中。

参数

-ApplicationName

指定 Service Fabric 应用程序的统一资源标识符 (URI) 。 该 cmdlet 使用指定的名称创建 Service Fabric 应用程序。

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

-ApplicationParameter

指定应用程序清单中定义的应用程序参数的替代作为键/值对。 该 cmdlet 创建应用程序类型的 Service Fabric 应用程序，并使用这些参数的重写值。 此处重写的参数必须存在于应用程序清单中。

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

-ApplicationTypeName

指定 Service Fabric 应用程序类型的名称。 该 cmdlet 将创建指定的应用程序类型的 Service Fabric 应用程序。

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

-ApplicationTypeVersion

指定 Service Fabric 应用程序类型的版本。 该 cmdlet 将创建一个具有指定版本的应用程序。

Type:String
Position:2
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

指定 Service Fabric 为此应用程序保留容量的最小节点数，这并不意味着应用程序保证在所有这些节点上具有副本。 此参数的值必须是非负整数。 此值的默认值为零，这意味着不会为应用程序保留容量。

Type:Int64
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