Condividi tramite

New-ServiceFabricServiceFromTemplate

  • Riferimento
Modulo:
ServiceFabric

Se il manifesto dell'applicazione ha definito una sezione modelli di servizio, questo comando può essere usato per creare nuovi servizi con parametri di descrizione del servizio popolati dal modello.

Sintassi

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

Descrizione

New-ServiceFabricService include diversi parametri obbligatori che descrivono il servizio da creare. I modelli di servizio nel manifesto dell'applicazione possono essere usati per specificare i parametri di descrizione del servizio in base al tipo di servizio. Lo schema della descrizione del servizio nella sezione modello di servizio corrisponde allo schema della descrizione del servizio per i servizi predefiniti . In questo modo è possibile creare nuovi servizi di un tipo di servizio specifico senza specificare parametri che altrimenti sarebbero stati obbligatori per New-ServiceFabricService.

I servizi creati usando un modello di servizio si comportano in modo identico ai servizi creati usando New-ServiceFabricService. Possono essere aggiornati, aggiornati e rimossi usando gli stessi flussi di lavoro.

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster.

Esempio

Esempio 1: Creare un servizio da un modello di servizio

Dati i manifesti dell'applicazione e del servizio seguenti:

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

Il comando seguente crea un servizio di Service Fabric usando il modello di servizio per il tipo di servizio MyServiceType definito nel manifesto dell'applicazione:

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

È possibile creare più istanze del servizio usando lo stesso modello di servizio. Dopo aver eseguito anche il comando seguente, sono disponibili due servizi singleton senza stato di tipo MyServiceType:

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

Parametri

-ApplicationName

Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric in cui creare il servizio.

Tipo:Uri
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza l'esecuzione del comando senza chiedere conferma dell'utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceName

Specifica l'URI di un servizio di Service Fabric.

Tipo:Uri
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServicePackageActivationMode

Controlla il [modello di hosting][1] da usare per il servizio. I valori validi sono SharedProcess e ExclusiveProcess. Il valore predefinito è SharedProcess.

Con modalità di attivazione SharedProcess, le repliche o le istanze di servizi diversi di un determinato ServiceType condivideranno lo stesso ServiceHost. Con modalità di attivazione exclusiveProcess, ogni replica o istanza di un servizio avrà un proprio ServiceHost dedicato. Per altri dettagli, vedere [Modello di hosting di Service Fabric][1].

Tipo:ServicePackageActivationMode
Valori accettati:SharedProcess, ExclusiveProcess
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceTypeName

Specifica il nome di un tipo di servizio di Service Fabric per il quale è presente un modello di servizio definito nel manifesto dell'applicazione.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object