Dela via

New-ServiceFabricServiceFromTemplate

  • Referens
Modul:
ServiceFabric

Om programmanifestet har definierat ett avsnitt för 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. På så sätt kan du 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 skapas 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 en åtgärd på 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

Baserat på 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 tjänstmallen för tjänsttypen MyServiceType som definierats 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 som tjänsten ska skapas i.

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

-Force

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

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

-ServiceDnsName

{{Fyll i ServiceDnsName-beskrivning}}

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

-ServiceName

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

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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äget delar repliker (eller instanser) av olika tjänster för en viss ServiceType samma ServiceHost. Med ExclusiveProcess-aktiveringsläget har varje replik eller instans av en tjänst sin egen dedikerade ServiceHost. Mer information finns i [Service Fabric Hosting Model][1].

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

-ServiceTypeName

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

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

-TimeoutSec

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

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

Indata

None

Utdata

System.Object