Freigeben über

New-ServiceFabricServiceFromTemplate

  • Referenz
Modul:
ServiceFabric

Wenn das Anwendungsmanifest einen Abschnitt mit Dienstvorlagen definiert hat, kann dieser Befehl verwendet werden, um neue Dienste mit Dienstbeschreibungsparametern zu erstellen, die aus der Vorlage aufgefüllt werden.

Syntax

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

Beschreibung

New-ServiceFabricService verfügt über mehrere obligatorische Parameter, die den zu erstellenden Dienst beschreiben. Dienstvorlagen im Anwendungsmanifest können verwendet werden, um Dienstbeschreibungsparameter pro Diensttypbasis anzugeben. Das Dienstbeschreibungsschema im Abschnitt "Dienstvorlagen" entspricht dem Dienstbeschreibungsschema für Standarddienste. Dies ermöglicht das Erstellen neuer Dienste eines bestimmten Diensttyps ohne Angabe von Parametern, die andernfalls für New-ServiceFabricServiceerforderlich wären.

Dienste, die mit einer Dienstvorlage erstellt wurden, verhalten sich identisch mit Diensten, die mit New-ServiceFabricServiceerstellt wurden. Sie können mit denselben Workflows aktualisiert, aktualisiert und entfernt werden.

Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Erstellen eines Diensts aus einer Dienstvorlage

Angesichts der folgenden Anwendungs- und Dienstmanifeste:

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

Der folgende Befehl erstellt einen Service Fabric-Dienst mithilfe der Dienstvorlage für den Diensttyp MyServiceType- im Anwendungsmanifest definiert:

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

Mehrere Dienstinstanzen können mit derselben Dienstvorlage erstellt werden. Nach dem Ausführen des folgenden Befehls gibt es zwei singleton stateless-Dienste vom Typ MyServiceType:

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

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an, in der der Dienst erstellt werden soll.

Typ:Uri
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den URI eines Service Fabric-Diensts an.

Typ:Uri
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServicePackageActivationMode

Steuert das [Hostingmodell][1], das für den Dienst verwendet werden soll. Gültige Werte sind SharedProcess- und ExclusiveProcess-. Der Standardwert ist SharedProcess-.

Mit SharedProcess- Aktivierungsmodus verwenden Replikate (oder Instanzen) verschiedener Dienste eines bestimmten ServiceType- denselben ServiceHost-. Mit ExclusiveProcess Aktivierungsmodus verfügt jedes Replikat oder jede Instanz eines Diensts über eine eigene dedizierte ServiceHost-. Weitere Informationen finden Sie unter [Service Fabric Hosting Model][1].

Typ:ServicePackageActivationMode
Zulässige Werte:SharedProcess, ExclusiveProcess
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceTypeName

Gibt den Namen eines Service Fabric-Diensttyps an, für den im Anwendungsmanifest eine Dienstvorlage definiert ist.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object