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 установите подключение к кластеру с помощью командлета 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 для управления ресурсами в кластере. Дополнительные сведения о метриках и управлении ресурсами в Service Fabric см. в статье Общие сведения о кластере Service Fabric Resource Manager. Каждая метрика может следовать шаблону MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity или использовать имена метрики и использовать имена параметров 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