New-ServiceFabricServiceFromTemplate

  • Referens
Modul:
ServiceFabric

Om programmanifestet har definierat ett avsnitt med tjänstmallar kan det här kommandot användas för att skapa nya tjänster med tjänstbeskrivningsparametrar ifyllda från mallen.

Syntax

New-ServiceFabricServiceFromTemplate
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   [-Force]
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-ServiceDnsName <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

New-ServiceFabricService har flera obligatoriska parametrar som beskriver tjänsten som skapas. Tjänstmallar i programmanifestet kan användas för att ange tjänstbeskrivningsparametrar per tjänsttyp. Tjänstbeskrivningsschemat i avsnittet tjänstmall är detsamma som tjänstbeskrivningsschemat för standardtjänster. Detta gör det möjligt att skapa nya tjänster av en viss tjänsttyp utan att ange parametrar som annars skulle ha varit obligatoriska för New-ServiceFabricService.

Tjänster som skapats med hjälp av en tjänstmall fungerar identiskt med tjänster som skapats med New-ServiceFabricService. De kan uppgraderas, uppdateras och tas bort med samma arbetsflöden.

Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster.

Exempel

Exempel 1: Skapa en tjänst från en tjänstmall

Med följande program- och tjänstmanifest:

<?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>

Följande kommando skapar en Service Fabric-tjänst med hjälp av tjänstmallen för tjänsttypen MyServiceType definierat i programmanifestet:

PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice1 -ServiceTypeName MyServiceType

Flera tjänstinstanser kan skapas med samma tjänstmall. När du har kört följande kommando finns det två tillståndslösa singleton-tjänster av typen MyServiceType:

PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice2 -ServiceTypeName MyServiceType

Parametrar

-ApplicationName

Anger URI (Uniform Resource Identifier) för ett Service Fabric-program för att skapa tjänsten i.

Typ:Uri
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceName

Anger URI för en Service Fabric-tjänst.

Typ:Uri
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServicePackageActivationMode

Styr [värdmodellen][1] som ska användas för tjänsten. Giltiga värden är SharedProcess och ExclusiveProcess. Standardvärdet är SharedProcess.

Med SharedProcess aktiveringsläge delar repliker (eller instanser) av olika tjänster för en viss ServiceType samma ServiceHost-. Med ExclusiveProcess aktiveringsläge har varje replik eller instans av en tjänst sin egen dedikerade ServiceHost. Mer information finns i [Service Fabric Hosting Model][1].

Typ:ServicePackageActivationMode
Godkända värden:SharedProcess, ExclusiveProcess
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceTypeName

Anger namnet på en Service Fabric-tjänsttyp som det finns en tjänstmall definierad för i programmanifestet.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object