Set-CsServerApplication

Skype for Business Server 2015
 

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

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

Set-CsServerApplication [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsServerApplication [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-Script <String>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Команда в примере 1 обеспечивает работу серверного приложения с удостоверением Registrar:atl-cs-001.litwareinc.com/ExumRouting. Так как удостоверения должны уникальными, эта команда включает только одно серверное приложение.

Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True

В примере 2 включаются все отключенные серверные приложения. В этих целях сначала вызывается командлет Get-CsServerApplication для получения коллекции всех используемых в организации серверных приложений. Затем эта коллекция передается в командлет Where-Object , который отбирает только те приложения, свойство Enabled которых имеет значение False. В свою очередь, фильтрованная коллекция передается в командлет Set-CsServerApplication , который для каждого элемента коллекции присваивает свойству Enabled значение True.

Get-CsServerApplication | Where-Object {$_.Enabled -eq $False} | Set-CsServerApplication -Enabled $True

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

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Critical

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

System.Boolean

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

Enabled

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

System.Boolean

Установите для параметра значение True, чтобы включить приложение. Установите значение False, чтобы выключить приложение.

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Instance

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

Объект ServerApplication.Application

Позволяет передать в командлет ссылку на объект вместо задания значений отдельных параметров.

Priority

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

System.Int32

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

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

Script

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

System.String

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

-Script "Update.ps1"

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

-Script $Null

Каждое серверное приложение можно сопоставить только с одним скриптом.

ScriptName

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

System.String

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

Uri

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

System.String

URI приложения. Например, URI приложения QoEAgent является http://www.microsoft.com/LCS/QoEAgent.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Командлет Set-CsServerApplication принимает из конвейера экземпляры объекта серверного приложения.

Командлет Set-CsServerApplication не возвращает значение или объект. Вместо этого командлет настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application.

 
Показ: