New-ServiceFabricServiceFromTemplate
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.
Syntax
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. 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 do serviço na seção de modelo de serviço é o mesmo que o esquema de descrição do 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, teriam sido 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
Considerando os seguintes manifestos de aplicativo 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 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 para criar o serviço.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
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 o URI de um serviço do Service Fabric.
Type: | Uri |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 o modo de ativação sharedprocess , réplicas (ou instâncias) de serviços diferentes de um determinado ServiceType compartilharão o mesmo ServiceHost. Com o modo de ativação ExclusiveProcess , cada réplica ou instância de um serviço terá seu próprio ServiceHost dedicado. Para obter mais detalhes, consulte [Modelo de Hospedagem do 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 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.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
System.Object