Delen via

New-ServiceFabricServiceFromTemplate

  • Referentie
Module:
ServiceFabric

Als het toepassingsmanifest een sectie met servicesjablonen heeft gedefinieerd, kan deze opdracht worden gebruikt om nieuwe services te maken met servicebeschrijvingsparameters die zijn ingevuld op basis van de sjabloon.

Syntax

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

Description

New-ServiceFabricService heeft verschillende verplichte parameters waarmee de service wordt beschreven die wordt gemaakt. Servicesjablonen in het toepassingsmanifest kunnen worden gebruikt om servicebeschrijvingsparameters per servicetype op te geven. Het servicebeschrijvingsschema in de sectie servicesjabloon is hetzelfde als het schema voor servicebeschrijvingen voor standaardservices. Hierdoor kunnen nieuwe services van een bepaald servicetype worden gemaakt zonder parameters op te geven die anders verplicht zouden zijn geweest voor New-ServiceFabricService.

Services die zijn gemaakt met behulp van een servicesjabloon gedragen zich identiek aan services die zijn gemaakt met new-ServiceFabricService. Ze kunnen worden bijgewerkt, bijgewerkt en verwijderd met dezelfde werkstromen.

Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .

Voorbeelden

Voorbeeld 1: Een service maken op basis van een servicesjabloon

Gezien de volgende toepassings- en servicemanifesten:

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

Met de volgende opdracht maakt u een Service Fabric-service met behulp van de servicesjabloon voor het servicetype MyServiceType dat is gedefinieerd in het toepassingsmanifest:

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

Er kunnen meerdere service-exemplaren worden gemaakt met dezelfde servicesjabloon. Nadat u de volgende opdracht hebt uitgevoerd, zijn er twee stateless services van het type MyServiceType:

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

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op waarin de service moet worden gemaakt.

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

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

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

Hiermee geeft u de URI van een Service Fabric-service.

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

-ServicePackageActivationMode

Hiermee bepaalt u het [hostingmodel][1] dat moet worden gebruikt voor de service. Geldige waarden zijn SharedProcess en ExclusiveProcess. De standaardwaarde is SharedProcess.

Met de activeringsmodus SharedProcess delen replica's (of exemplaren) van verschillende services van een bepaald ServiceType dezelfde ServiceHost. Met de activeringsmodus ExclusiveProcess heeft elke replica of elk exemplaar van een service een eigen toegewezen ServiceHost. Zie [Service Fabric Hosting Model][1] voor meer informatie.

Type:ServicePackageActivationMode
Accepted values:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceTypeName

Hiermee geeft u de naam van een Service Fabric-servicetype waarvoor er een servicesjabloon is gedefinieerd in het toepassingsmanifest.

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

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, op voor de bewerking.

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

Invoerwaarden

None

Uitvoerwaarden

System.Object