Condividi tramite

New-ServiceFabricServiceFromTemplate

  • Riferimento
Modulo:
ServiceFabric

Se il manifesto dell'applicazione ha definito una sezione dei modelli di servizio, questo comando può essere usato per creare nuovi servizi con i 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 creato. 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. Ciò consente di creare nuovi servizi di un particolare tipo di servizio 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 con 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

Dato 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 il comando seguente, sono disponibili due servizi senza stato singleton 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.

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

-Force

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

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

-ServiceDnsName

{{Fill ServiceDnsName Description}}

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

-ServiceName

Specifica l'URI di un servizio di Service Fabric.

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

-ServicePackageActivationMode

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

Con la modalità di attivazione SharedProcess , le repliche (o le istanze) di servizi diversi di un determinato ServiceType condivideranno lo stesso ServiceHost. Con la 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].

Type:ServicePackageActivationMode
Accepted values:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-TimeoutSec

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

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

Input

None

Output

System.Object