你当前正在访问 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 应用程序。

类型:	Uri
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationParameter

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

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ApplicationTypeName

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

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationTypeVersion

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

类型:	String
Position:	2
默认值:	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 ，后跟参数值，并使用冒号分隔。每个参数 名称：值 对最多可以显示一次。

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

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

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeoutSec

指定操作的超时时间段（以秒为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

System.Object

通过