Partilhar via

New-ServiceFabricServiceFromTemplate

  • Referência
Módulo:
ServiceFabric

Se o manifesto do aplicativo tiver definido uma seção de modelos de serviço, esse comando poderá ser usado para criar novos serviços com parâmetros de descrição de serviço preenchidos a partir do modelo.

Sintaxe

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

Description

New-ServiceFabricService tem vários parâmetros obrigatórios que descrevem o serviço que está sendo criado. Os modelos de serviço no manifesto do aplicativo podem ser usados para especificar parâmetros de descrição de serviço por tipo de serviço. O esquema de descrição de serviço na seção de modelo de serviço é o mesmo que o esquema de descrição de serviço para serviços padrão. Isso permite a criação de novos serviços de um tipo de serviço específico sem especificar parâmetros que, de outra forma, seriam obrigatórios para New-ServiceFabricService.

Os serviços criados usando um modelo de serviço se comportam de forma idêntica aos serviços criados usando New-ServiceFabricService. Eles podem ser atualizados, atualizados e removidos usando os mesmos fluxos de trabalho.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.

Exemplos

Exemplo 1: Criar um serviço a partir de um modelo de serviço

Tendo em conta os seguintes manifestos de aplicação e serviço:

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

O comando a seguir cria um serviço do Service Fabric usando o modelo de serviço para o tipo de serviço MyServiceType definido no manifesto do aplicativo:

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

Várias instâncias de serviço podem ser criadas usando o mesmo modelo de serviço. Depois de executar adicionalmente o seguinte comando, há dois serviços sem estado singleton do tipo MyServiceType:

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

Parâmetros

-ApplicationName

Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric no qual criar o serviço.

Tipo:Uri
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServiceDnsName

{{Fill ServiceDnsName Descrição}}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServiceName

Especifica o URI de um serviço do Service Fabric.

Tipo:Uri
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServicePackageActivationMode

Controla o [modelo de hospedagem][1] a ser usado para o serviço. Os valores válidos são SharedProcess e ExclusiveProcess. O padrão é SharedProcess.

Com modo de ativação SharedProcess, réplicas (ou instâncias) de diferentes serviços de um determinado ServiceType compartilharão o mesmo ServiceHost. Com modo de ativação ExclusiveProcess, cada réplica ou instância de um serviço terá seu próprio dedicado ServiceHost. Para obter mais detalhes, consulte [Modelo de hospedagem do Service Fabric][1].

Tipo:ServicePackageActivationMode
Valores aceites:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServiceTypeName

Especifica o nome de um tipo de serviço do Service Fabric para o qual há um modelo de serviço definido no manifesto do aplicativo.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object