Поделиться через

New-ServiceFabricServiceFromTemplate

  • Ссылка
Модуль:
ServiceFabric

Если манифест приложения определил раздел шаблонов служб, эту команду можно использовать для создания новых служб с параметрами описания службы, заполненными из шаблона.

Синтаксис

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

Описание

New-ServiceFabricService имеет несколько обязательных параметров, описывающих созданную службу. Шаблоны служб в манифесте приложения можно использовать для указания параметров описания службы на основе каждого типа службы. Схема описания службы в разделе шаблона службы аналогична схеме описания службы для служб по умолчанию. Это позволяет создавать новые службы определенного типа службы без указания параметров, которые в противном случае были бы обязательными для New-ServiceFabricService.

Службы, созданные с помощью шаблона службы, ведут себя идентично службам, созданным с помощью New-ServiceFabricService. Их можно обновить, обновить и удалить с помощью одних и того же рабочего процесса.

Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Создание службы на основе шаблона службы

Учитывая следующие манифесты приложения и службы:

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

Следующая команда создает службу Service Fabric с помощью шаблона службы для типа службы MyServiceType , определенного в манифесте приложения:

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

Несколько экземпляров служб можно создать с помощью одного шаблона службы. После выполнения следующей команды существует две одноэлементные службы без отслеживания состояния типа MyServiceType:

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

Параметры

-ApplicationName

Указывает универсальный код ресурса (URI) приложения Service Fabric для создания службы.

Тип:Uri
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServiceName

Указывает универсальный код ресурса (URI) службы Service Fabric.

Тип:Uri
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServicePackageActivationMode

Управляет [моделью размещения][1], которая будет использоваться для службы. Допустимые значения: SharedProcess и ExclusiveProcess. Значение по умолчанию — SharedProcess.

В режиме активации SharedProcess реплики (или экземпляры) разных служб заданного типа ServiceType будут совместно использовать один и тот же ServiceHost. В режиме активации ExclusiveProcess каждая реплика или экземпляр службы будет иметь собственную выделенную службу ServiceHost. Дополнительные сведения см. в разделе [Модель размещения Service Fabric][1].

Тип:ServicePackageActivationMode
Допустимые значения:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServiceTypeName

Указывает имя типа службы Service Fabric, для которого существует шаблон службы, определенный в манифесте приложения.

Тип:String
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimeoutSec

Указывает период времени ожидания (в секундах) для операции.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

System.Object