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


New-ServiceFabricApplication

Создает приложение Service Fabric.

Синтаксис

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Описание

Командлет New-ServiceFabricApplication создает приложение Service Fabric зарегистрированного типа приложения. Используйте командлет Register-ServiceFabricApplicationType для регистрации типа приложения.

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

Примеры

Пример 1. Создание приложения

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

Эта команда создает приложение типа PersistentToDoListApp. Приложение версии 1.0. Тип и версия приложения поступают из манифеста приложения в пакете приложения, который использовался при регистрации приложения с помощью командлета Register-ServiceFabricApplicationType .

Пример 2. Создание приложения путем переопределения значений параметров по умолчанию в манифесте приложения

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

Эта команда создает приложение типа PersistentToDoListApp и версии 1.0 с переопределенными значениями для параметров CustomParameter1 и CustomParameter2. Эти имена параметров должны существовать в манифесте приложения пакета приложения, который использовался при регистрации приложения с помощью командлета Register-ServiceFabricApplicationType .

Параметры

-ApplicationName

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

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

-ApplicationParameter

Задает переопределения для параметров приложения, определенных в манифесте приложения, в виде пар "ключ-значение". Командлет создает приложение Service Fabric типа приложения и использует переопределенные значения для этих параметров. Параметры, которые переопределяются здесь, должны существовать в манифесте приложения.

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

-ApplicationTypeName

Указывает имя типа приложения Service Fabric. Командлет создает приложение Service Fabric указанного типа приложения.

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

-ApplicationTypeVersion

Указывает версию типа приложения Service Fabric. Командлет создает приложение с указанной версией.

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

-MaximumNodes

Указывает максимальное количество узлов, на которых будет размещаться приложение. Значение этого параметра должно быть неотрицательно целым числом. Значение по умолчанию — 0, указывающее, что приложение можно разместить на любом количестве узлов в кластере.

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

-Metrics

Задает массив метрик. Эти метрики используются кластером Service Fabric Resource Manager для управления ресурсами в кластере. Дополнительные сведения о метриках и управлении ресурсами в Service Fabric см. в разделе "Общие сведения о кластере Service Fabric Resource Manager". Каждая метрика может соответствовать шаблону MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity или указать MetricName и использовать имена параметров NodeReservationCapacity, MaximumNodeCapacity или TotalApplicationCapacity , за которым следует значение параметра, и разделять двоеточием. Каждая пара параметров name:value может отображаться не более одного раза.

  • MetricName. Указывает имя метрики.
  • NodeReservationCapacity. Указывает объем нагрузки метрик, зарезервированной на узлах с экземплярами этого приложения. Если указано MinimumNodes , продукт этих значений является емкостью, зарезервированной в кластере для приложения.
  • MaximumNodeCapacity. Указывает максимальную нагрузку для экземпляра этого приложения на одном узле. Даже если емкость узла больше этого значения, Service Fabric ограничивает общую нагрузку дочерних реплик приложения этим значением.
  • TotalApplicationCapacity. Указывает общую емкость приложения в кластере. Service Fabric пытается ограничить сумму загрузки дочерних реплик приложения этим значением.

При создании приложения Service Fabric выполняет следующие проверки и завершится сбоем команды, если они не проходят:

  • Значение NodeReservationCapacity не должно превышать MaximumNodeCapacity.

  • Если указаны оба параметра MinimumNodes и метрика NodeReservationCapacity, продукт MinimumNodes и NodeReservationCapacity не должен превышать TotalApplicationCapacity. Дополнительные сведения см. в разделе "Метрики приложений", "Загрузка" и "Емкость"

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

-MinimumNodes

Указывает минимальное количество узлов, в которых Service Fabric будет резервировать емкость для этого приложения, это не означает, что приложение гарантированно будет иметь реплики на всех этих узлах. Значение этого параметра должно быть неотрицательно целым числом. Значение по умолчанию для этого параметра равно нулю, что означает, что для приложения не зарезервирована емкость.

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

-TimeoutSec

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

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

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

None

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

System.Object