New-ServiceFabricServiceFromTemplate

  • Referencia
Módulo:
ServiceFabric

Si el manifiesto de aplicación ha definido una sección de plantillas de servicio, este comando se puede usar para crear nuevos servicios con parámetros de descripción del servicio rellenados a partir de la plantilla.

Syntax

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

Description

New-ServiceFabricService tiene varios parámetros obligatorios que describen el servicio que se está creando. Las plantillas de servicio del manifiesto de aplicación se pueden usar para especificar parámetros de descripción del servicio por tipo de servicio. El esquema de descripción del servicio en la sección de plantilla de servicio es el mismo que el esquema de descripción del servicio para los servicios predeterminados. Esto permite crear nuevos servicios de un tipo de servicio determinado sin especificar parámetros que, de lo contrario, habrían sido obligatorios para New-ServiceFabricService.

Los servicios creados con una plantilla de servicio se comportan de forma idéntica a los servicios creados mediante New-ServiceFabricService. Se pueden actualizar, actualizar y quitar mediante los mismos flujos de trabajo.

Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .

Ejemplos

Ejemplo 1: Creación de un servicio a partir de una plantilla de servicio

Dados los siguientes manifiestos de aplicación y servicio:

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

El siguiente comando crea un servicio de Service Fabric mediante la plantilla de servicio para el tipo de servicio MyServiceType definido en el manifiesto de aplicación:

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

Se pueden crear varias instancias de servicio con la misma plantilla de servicio. Después de ejecutar el siguiente comando, hay dos servicios sin estado singleton de tipo MyServiceType:

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

Parámetros

-ApplicationName

Especifica el identificador uniforme de recursos (URI) de una aplicación de Service Fabric en la que se va a crear el servicio.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

Especifica el URI de un servicio de Service Fabric.

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

-ServicePackageActivationMode

Controla el [modelo de hospedaje][1] que se va a usar para el servicio. Los valores válidos son SharedProcess y ExclusiveProcess. El valor predeterminado es SharedProcess.

Con el modo de activación SharedProcess , las réplicas (o instancias) de diferentes servicios de un ServiceType determinado compartirán el mismo ServiceHost. Con el modo de activación ExclusiveProcess , cada réplica o instancia de un servicio tendrá su propio ServiceHost dedicado. Para más información, consulte [Modelo de hospedaje de 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

Especifica el nombre de un tipo de servicio de Service Fabric para el que hay una plantilla de servicio definida en el manifiesto de aplicación.

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

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

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

Entradas

None

Salidas

System.Object