Partager via

New-ServiceFabricServiceFromTemplate

  • Référence
Module:
ServiceFabric

Si le manifeste de l’application a défini une section modèles de service, cette commande peut être utilisée pour créer de nouveaux services avec des paramètres de description de service renseignés à partir du modèle.

Syntaxe

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

Description

new-ServiceFabricService a plusieurs paramètres obligatoires qui décrivent le service en cours de création. Les modèles de service dans le manifeste d’application peuvent être utilisés pour spécifier des paramètres de description de service par type de service. Le schéma de description du service dans la section modèle de service est identique au schéma de description de service pour services par défaut. Cela permet de créer de nouveaux services d’un type de service particulier sans spécifier de paramètres qui auraient autrement été obligatoires pour New-ServiceFabricService.

Les services créés à l’aide d’un modèle de service se comportent de la même façon que les services créés à l’aide de New-ServiceFabricService. Ils peuvent être mis à niveau, mis à jour et supprimés à l’aide des mêmes flux de travail.

Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster.

Exemples

Exemple 1 : Créer un service à partir d’un modèle de service

Compte tenu des manifestes d’application et de service suivants :

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

La commande suivante crée un service Service Fabric à l’aide du modèle de service pour le type de service MyServiceType défini dans le manifeste de l’application :

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

Plusieurs instances de service peuvent être créées à l’aide du même modèle de service. Après avoir exécuté la commande suivante, il existe deux services sans état singleton de type MyServiceType:

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

Paramètres

-ApplicationName

Spécifie l’URI (Uniform Resource Identifier) d’une application Service Fabric dans laquelle créer le service.

Type:Uri
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServiceName

Spécifie l’URI d’un service Service Fabric.

Type:Uri
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePackageActivationMode

Contrôle le [modèle d’hébergement][1] à utiliser pour le service. Les valeurs valides sont SharedProcess et exclusiveProcess. La valeur par défaut est SharedProcess.

Avec mode d’activation SharedProcess, les réplicas (ou instances) de différents services d’un ServiceType donné partageront le même ServiceHost. Avec mode d’activation exclusiveProcess, chaque réplica ou instance d’un service aura son propre ServiceHost dédié. Pour plus d’informations, consultez [Modèle d’hébergement Service Fabric][1].

Type:ServicePackageActivationMode
Valeurs acceptées:SharedProcess, ExclusiveProcess
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServiceTypeName

Spécifie le nom d’un type de service Service Fabric pour lequel il existe un modèle de service défini dans le manifeste de l’application.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object