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

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:/myapp -ServiceName fabric:/myapp/myservice1 -ServiceTypeName MyServiceType

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

PS C: структура> New-ServiceFabricServiceFromTemplate -ApplicationName:/myapp -ServiceName fabric:/myapp/myservice2 -ServiceTypeName MyServiceType

Параметры

-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