New-CsServerApplication

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Создает новое серверное приложение. Серверные приложения — это приложения, которые размещает Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

New-CsServerApplication -Name <String> -Parent <String> <COMMON PARAMETERS>
New-CsServerApplication -Identity <XdsIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-Script <String>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]

В примере 1 создается новое серверное приложение с удостоверением EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor. Помимо удостоверения используются параметры Uri и Critical, с помощью которых указывается URI приложения, а также тот факт, что приложение не является критическим.

New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False

В примере 2 показано, как можно создать новое серверное приложение, первоначально существующее только в памяти. Для этого первая команда вызывает командлет New-CsServerApplication с двумя параметрами: Identity (указывает удостоверение для приложения) и InMemory (указывает, что новое приложение должно создаваться только в памяти). Затем полученный в результате объект серверного приложения сохраняется в переменной $x.

После создания виртуального серверного приложения выполняются команды 2 и 3 для изменения значений свойств Uri и Critical соответственно. Наконец, с помощью команды 4 виртуальное серверное приложение преобразуется в реальное серверное приложение. Эта последняя команда является обязательной. Если не вызвать командлет Set-CsServerApplication , приложение не будет настроено для удостоверения EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor и виртуальное приложение исчезнет сразу после завершения сеанса Windows PowerShell или удаления переменной $x.

$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x

Серверными приложениями называются отдельные программы, работающие в среде сервера Skype для бизнеса Server 2015. Командлет New-CsServerApplication предоставляет администраторам способ настройки новых серверных приложений.

По умолчанию запускать командлет New-CsServerApplication локально могут участники следующих групп: RTCUniversalServerAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которые были назначены для этого командлета (включая все созданные вами роли RBAC), выполните следующую команду из командной строки Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsServerApplication"}

 

Параметр Обязательный? Тип Описание

Identity

Обязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор для создаваемого серверного приложения. Свойства Identity серверных приложений состоят из названия службы, где размещается приложение, и имени приложения. Например, серверное приложение QoEAgent может иметь свойство Identity следующего вида: service:Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Name

Обязательный

System.String

Понятное имя для службы. Если при создании новой службы используется параметр Identity, то нет необходимости включать параметр Name; свойство Name будет заполняться из той части удостоверения приложения, которая представляет имя. Например, если создается новое приложение с удостоверением service:Registrar:atl-cs-001.litwareinc.com/TestService, приложение автоматически получает имя TestService. Параметр Name обязателен только при использовании параметра Parent.

Parent

Обязательный

System.String

Указывает службу, в которой будет размещаться новое серверное приложение. Если используется параметр Identity, то нет необходимости указывать параметр Parent или Name, поскольку в удостоверении приложения соединяются значения свойств Parent и Name. Однако можно опустить параметр Identity и использовать вместо него параметры Parent и Name. В этом случает параметр Parent должен выглядеть следующим образом: -Parent "Registrar:atl-cs-001.litwareinc.com".

Uri

Обязательный

System.String

Уникальный универсальный код ресурса (URI) для приложения. Например, URI приложения QoEAgent: http://www.microsoft.com/LCS/QoEAgent.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Critical

Необязательный

System.Boolean

Если задано значение True, то Skype для бизнеса Server 2015 не запустится, если нельзя будет запустить обсуждаемое приложение. Если задано значение False, то Skype для бизнеса Server 2015 запустится независимо от возможности запуска приложения. Если этот параметр не указывается, свойству Critical присваивается значение True.

Enabled

Необязательный

System.Boolean

Задайте значение True, чтобы включить приложение. Задайте значение False, чтобы отключить приложение. Если этот параметр не указывается, свойству Enabled присваивается значение False, и новое приложение отключается.

Force

Необязательный

System.Management.Automation.SwitchParameter

Запрещает на время выполнения команды отображение каких-либо сообщений о некритических ошибках.

InMemory

Необязательный

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

Priority

Необязательный

System.Int32

Показывает порядок выполнения серверных приложений. Первым запускается приложение с приоритетом 0, вторым — приложение с приоритетом 1 и т. д. Имейте в виду, что каждая служба, в которой размещается серверное приложение, имеет собственный уникальный набор приоритетов. Например, служба Registrar может вмещать три приложения с соответствующими приоритетами 0, 1 и 2. Аналогично служба Пограничный сервера может содержать четыре приложения, которые будут иметь приоритеты 0, 1, 2 и 3.

Если вы не указываете приоритет, приложение автоматически добавляется в конец списка приоритетов. Если вы добавляете или удаляете приложение, приоритеты других приложений меняются соответственно. Например, если удалить приложение с приоритетом 0, то приложение, ранее имевшее приоритет 1, автоматически получает приоритет 0.

Script

Необязательный

System.String

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

-Script "Update.ps1"

Чтобы удалить сценарий, просто задайте для свойства Script нулевое значение:

-Script $Null

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

ScriptName

Необязательный

System.String

Путь к сценарию MSPL (Microsoft SIP Processing Language), который использует приложение (при наличии). MSPL — это язык сценариев, используемый для фильтрации и маршрутизации SIP-сообщений.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Нет. Командлет New-CsServerApplication не принимает конвейерные входные данные.

New-CsServerApplication создает новые экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

 
Показ: