你当前正在访问 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) 。

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

-Force

强制运行命令而不要求用户确认。

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

-ServiceDnsName

{{Fill ServiceDnsName Description}}

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

-ServiceName

指定 Service Fabric 服务的 URI。

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

-ServicePackageActivationMode

控制要用于服务的 [宿主模型][1]。 有效值为 SharedProcessExclusiveProcess。 默认值为 SharedProcess

使用 SharedProcess 激活模式,给定 ServiceType 的不同服务) 副本 (或实例将共享相同的 ServiceHost。 使用 ExclusiveProcess 激活模式,服务的每个副本或实例都将有自己的专用 ServiceHost。 有关详细信息,请参阅 [Service Fabric 托管模型][1]。

Type:ServicePackageActivationMode
Accepted values:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceTypeName

指定应用程序清单中定义了服务模板的 Service Fabric 服务类型的名称。

Type:String
Position:2
Default value:None
Required:True
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