Sdílet prostřednictvím

New-ServiceFabricServiceFromTemplate

  • Reference
Modul:
ServiceFabric

Pokud manifest aplikace definoval oddíl šablon služeb, můžete tento příkaz použít k vytvoření nových služeb s parametry popisu služby vyplněnými ze šablony.

Syntaxe

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

Description

New-ServiceFabricService má několik povinných parametrů, které popisují vytvářenou službu. Šablony služeb v manifestu aplikace lze použít k určení parametrů popisu služby na základě jednotlivých typů služby. Schéma popisu služby v části šablony služby je stejné jako schéma popisu služby pro výchozí služby. To umožňuje vytvářet nové služby konkrétního typu služby bez zadání parametrů, které by jinak byly pro New-ServiceFabricService povinné.

Služby vytvořené pomocí šablony služby se chovají stejně jako služby vytvořené pomocí New-ServiceFabricService. Je možné je upgradovat, aktualizovat a odebrat pomocí stejných pracovních postupů.

Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Vytvoření služby ze šablony služby

Vzhledem k následujícím manifestům aplikace a služby:

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

Následující příkaz vytvoří službu Service Fabric pomocí šablony služby pro typ služby MyServiceType definovaný v manifestu aplikace:

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

Pomocí stejné šablony služby je možné vytvořit několik instancí služby. Po dalším spuštění následujícího příkazu existují dvě bezstavové služby typu MyServiceType:

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

Parametry

-ApplicationName

Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric, ve které se má služba vytvořit.

Typ:Uri
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServiceName

Určuje identifikátor URI služby Service Fabric.

Typ:Uri
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServicePackageActivationMode

Řídí [hostitelský model][1], který se má použít pro službu. Platné hodnoty jsou SharedProcess a ExclusiveProcess. Výchozí hodnota je SharedProcess.

V režimu aktivace SharedProcess budou repliky (nebo instance) různých služeb daného typu služby sdílet stejnou službu ServiceHost. V režimu aktivace ExclusiveProcess bude mít každá replika nebo instance služby vlastní vyhrazenou službu ServiceHost. Další podrobnosti najdete v tématu [Model hostování Service Fabric][1].

Typ:ServicePackageActivationMode
Přípustné hodnoty:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServiceTypeName

Určuje název typu služby Service Fabric, pro který je v manifestu aplikace definována šablona služby.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeoutSec

Určuje časový limit operace v sekundách.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Object