你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-ServiceFabricServiceFromTemplate
如果应用程序清单定义了服务模板部分,则此命令可用于使用从模板填充的服务说明参数创建新服务。
语法
New-ServiceFabricServiceFromTemplate
[-ApplicationName] <Uri>
[-ServiceName] <Uri>
[-ServiceTypeName] <String>
[-Force]
[-ServicePackageActivationMode <ServicePackageActivationMode>]
[-ServiceDnsName <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
说明
New-ServiceFabricService 有几个必需的参数来描述正在创建的服务。 应用程序清单中的服务模板可用于根据每个服务类型指定服务说明参数。 服务模板部分中的服务说明架构与 默认服务的服务说明架构相同。 这允许创建特定服务类型的新服务,而无需指定 New-ServiceFabricService必需的参数。
使用服务模板创建的服务的行为与使用 New-ServiceFabricService
在 Service Fabric 群集上执行任何操作之前,请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。
示例
示例 1:从服务模板创建服务
给定以下应用程序和服务清单:
<?xml version="1.0" encoding="utf-8" ?>
<ApplicationManifest
ApplicationTypeName="MyApplicationType"
ApplicationTypeVersion="AppManifestVersion1"
xmlns="http://schemas.microsoft.com/2011/01/fabric"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Description>An example application manifest</Description>
<ServiceManifestImport>
<ServiceManifestRef ServiceManifestName="MyServiceManifest" ServiceManifestVersion="SvcManifestVersion1"/>
</ServiceManifestImport>
<ServiceTemplates>
<StatelessService ServiceTypeName="MyServiceType" InstanceCount="-1">
<SingletonPartition/>
</StatelessService>
</ServiceTemplates>
</ApplicationManifest>
<?xml version="1.0" encoding="utf-8" ?>
<ServiceManifest Name="MyServiceManifest" Version="SvcManifestVersion1" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Description>An example service manifest</Description>
<ServiceTypes>
<StatelessServiceType ServiceTypeName="MyServiceType" />
</ServiceTypes>
<CodePackage Name="MyCode" Version="CodeVersion1">
<EntryPoint>
<ExeHost>
<Program>MyServiceHost.exe</Program>
</ExeHost>
</EntryPoint>
</CodePackage>
</ServiceManifest>
以下命令使用服务模板为应用程序清单中定义的服务类型 MyServiceType 创建 Service Fabric 服务:
PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice1 -ServiceTypeName MyServiceType
可以使用同一服务模板创建多个服务实例。 另外运行以下命令后,MyServiceType类型有两个单一实例无状态服务:
PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice2 -ServiceTypeName MyServiceType
参数
-ApplicationName
指定要在其中创建服务的 Service Fabric 应用程序的统一资源标识符(URI)。
类型: | Uri |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Force
强制命令运行而不要求用户确认。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ServiceDnsName
{{Fill ServiceDnsName Description}}
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ServiceName
指定 Service Fabric 服务的 URI。
类型: | Uri |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-ServicePackageActivationMode
控制要用于服务的 [宿主模型][1]。 有效值为 SharedProcess 和 ExclusiveProcess。 默认值为 SharedProcess。
使用 SharedProcess 激活模式时,给定 serviceType 的不同服务的副本(或实例)将共享同一 ServiceHost。 使用 ExclusiveProcess 激活模式时,服务的每个副本或实例都将有自己的专用 ServiceHost。 有关详细信息,请参阅 [Service Fabric 托管模型][1]。
类型: | ServicePackageActivationMode |
接受的值: | SharedProcess, ExclusiveProcess |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ServiceTypeName
指定在应用程序清单中定义的服务模板的 Service Fabric 服务类型的名称。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-TimeoutSec
指定操作的超时期限(以秒为单位)。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
System.Object