New-ServiceFabricApplication
创建 Service Fabric 应用程序。
语法
Default （默认值）
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 Cluster 上执行任何操作之前，请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。
示例
示例 1：创建应用程序
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"
此命令创建类型为 PersistentToDoDoListApp 的应用程序。 该应用程序是 1.0 版。 应用程序类型和版本来自使用 Register-ServiceFabricApplicationType cmdlet 注册应用程序时使用的应用程序包中的应用程序清单。
示例 2：通过重写应用程序清单中的默认参数值来创建应用程序
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}
此命令创建类型为 PersistentToDoDoListApp 且版本为 1.0 的应用程序，其中包含参数 CustomParameter1 和 CustomParameter2 的重写值。 这些参数名称必须存在于 Register-ServiceFabricApplicationType cmdlet 注册应用程序时使用的应用程序包的应用程序清单中。
参数
-ApplicationName
指定 Service Fabric 应用程序的统一资源标识符 （URI）。 cmdlet 使用指定的名称创建 Service Fabric 应用程序。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ApplicationParameter
指定应用程序清单中定义为键/值对的应用程序参数的替代。 该 cmdlet 创建应用程序类型的 Service Fabric 应用程序，并对这些参数使用重写的值。 此处重写的参数必须存在于应用程序清单中。
参数属性
| 类型: | Hashtable |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ApplicationTypeName
指定 Service Fabric 应用程序类型的名称。 该 cmdlet 将创建指定的应用程序类型的 Service Fabric 应用程序。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ApplicationTypeVersion
指定 Service Fabric 应用程序类型的版本。 cmdlet 将创建一个具有指定版本的应用程序。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MaximumNodes
指定要在其上放置应用程序的最大节点数。 此参数的值必须是非负整数。 默认值为 0，指示应用程序可以放置在群集中任意数量的节点上。
参数属性
| 类型: | Int64 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Metrics
指定指标数组。 Service Fabric 群集资源管理器使用这些指标来管理群集中的资源。 有关 Service Fabric 中的指标和资源管理的详细信息，请参阅 Service Fabric 群集资源管理器简介。 每个指标都可以遵循 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[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MinimumNodes
指定 Service Fabric 将为此应用程序保留容量的最小节点数，这并不意味着保证应用程序在所有这些节点上都有副本。 此参数的值必须是非负整数。 默认值为零，这意味着没有为应用程序保留容量。
参数属性
| 类型: | Int64 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-TimeoutSec
指定作的超时时间（以秒为单位）。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。