Remove-CsWebServiceConfiguration

Skype for Business Server 2015
 

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

Удаляет одну или несколько коллекций параметров конфигурации веб-служба. Данный командлет впервые появился в Lync Server 2010.

Remove-CsWebServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Пример 1 удаляет параметры конфигурации службы для сайта Redmond.

Remove-CsWebServiceConfiguration -Identity site:Redmond

В примере 2 удаляются все параметры службы, настроенные в области действия сайта. Чтобы выполнить эту задачу сначала вызывается командлет Get-CsWebServiceConfiguration с параметром Filter. Значение фильтра ("site:*") позволяет убедиться, что возвращаются только параметры, свойство Identity которых начинается с "site:". Эта фильтрованная коллекция затем передается командлету Remove-CsWebServiceConfiguration , который удаляет каждый элемент коллекции.

Get-CsWebServiceConfiguration -Filter "site:*" | Remove-CsWebServiceConfiguration

Команда в примере 3 удаляет все параметры конфигурации служб, в которых расширение группы было отключено. Для этого сначала вызывается командлет Get-CsWebServiceConfiguration без параметров для получения коллекции всех параметров конфигурации служб, используемых в организации. Эта коллекция затем передается командлету Where-Object , который выбирает только те параметры, в которых значение свойства EnableGroupExpansion равно False. Фильтрованная коллекция передается командлету Remove-CsWebServiceConfiguration , который удаляет каждый элемент коллекции.

Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration

Многие компоненты Skype для бизнеса Server 2015 реализуются через Интернет: эти компоненты используют для выполнения задач либо веб-службы, либо веб-страницы. Например, пользователи задействуют веб-службу при поиске новых контактов в адресной книге либо при расширении группы для просмотра отдельных участников группы рассылки. Аналогично, компоненты, варьирующиеся от конференц-связи с телефонным подключением до панели Панель управления Skype для бизнеса Server используют веб-страницы в качестве интерфейса между Skype для бизнеса Server 2015 и пользователями.

Командлеты CsWebServiceConfiguration позволяют администраторам управлять параметрами конфигурации службы во всей организации. К ним относятся настройки управления расширением группы, параметры сертификатов и разрешенные методы проверки подлинности. Так как вы можете настроить различные параметры в глобальной области действия, а также в области действия сайта и службы (только для веб-службы), вы можете настроить возможности службы для различных пользователей и местоположений.

Если создать настраиваемые параметры конфигурации службы на уровне сайта или службы, эти параметры в дальнейшем можно удалить с помощью командлета Remove-CsWebServiceConfiguration . Учтите, что вы также можете выполнить Remove-CsWebServiceConfiguration для глобальной коллекции параметров службы. Однако в этом случае глобальная коллекция не удаляется, потому что Skype для бизнеса Server 2015 не разрешает удалить глобальные параметры. Вместо этого восстанавливаются значения по умолчанию для всех свойств глобальной коллекции. Например, предположим, что вы изменили значение MaxGroupSizeToExpand на 500. Так как значение этого свойства по умолчанию равно 100, при "удалении" глобальной коллекции для свойства MaxGroupSizeToExpand будет восстановлено значение 100.

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsWebServiceConfiguration"}

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор параметров конфигурации службы, которые необходимо удалить. Чтобы удалить параметры, настроенные на уровне сайта, используйте следующий синтаксис: -Identity "site:Redmond". Чтобы удалить параметры на уровне службы, используйте следующий синтаксис: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Командлет Remove-CsWebServiceConfiguration также можно применять к глобальной коллекции. В этом случае глобальная коллекция не удаляется, вместо этого восстанавливаются значения по умолчанию для всех свойств глобальной коллекции. Чтобы сбросить глобальную коллекцию, используйте следующий синтаксис: -Identity global.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Командлет Remove-CsWebServiceConfiguration принимает конвейерные входные данные объекта параметров служб.

Нет. Вместо этого командлет Remove-CsWebServiceConfiguration удаляет существующие экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.

 
Показ: