Remove-CsRegistrarConfiguration

Skype for Business Server 2015
 

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

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

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

Команда, представленная в примере 1, служит для удаления настроек конфигурации Registrar, назначенных для сайта Redmond. При удалении этих настроек компоненты Registrar на сайте Redmond автоматически используют глобальные настройки Registrar.

Remove-CsRegistrarConfiguration -Identity site:Redmond

В примере 2 показано удаление всех параметров конфигурации регистратора, назначенных в области службы. С этой целью команда сначала вызывает командлет Get-CsRegistrarConfiguration с параметром Filter. Значение фильтра "service:*" ограничивает возвращаемые данные параметрами, в которых свойство Identity начинается со строки "service:". После фильтрации коллекция передается командлету Remove-CsRegistrarConfiguration , который удаляет все элементы в этой коллекции.

Get-CsRegistrarConfiguration -Filter "service:*" | Remove-CsRegistrarConfiguration

В примере 3 удаляются все параметры конфигурации регистратора, в которых для свойства EnableDHCPServer задано значение True. Для этого команда сначала вызывает командлет Get-CsRegistrarConfiguration без параметров. В результате возвращается коллекция всех параметров конфигурации регистратора, используемый на данный момент. Эта коллекция затем передается командлету Where-Object , который выбирает только те параметры, в которых свойству EnableDHCPServer задано значение True. После фильтрации коллекция передается командлету Remove-CsRegistrarConfiguration , который удаляет все элементы в ней.

Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True} | Remove-CsRegistrarConfiguration

Registrar является, пожалуй, самым важным компонентом в Skype для бизнеса Server 2015; ведь без Registrar пользователи не смогли бы входить в систему, а Skype для бизнеса Server 2015 не удалось бы вести учет пользователей и их текущих статусов. Когда пользователь входит в систему Skype для бизнеса Server 2015, конечная точка, через которую пользователь входит, отправляет регистратору запрос REGISTER; в свою очередь, сервер отвечает, требуя у клиентского устройства учетные данные для проверки подлинности. Если клиент отвечает на это требование (т. е. предоставляет набор действительных учетных данных), то пользователь авторизуется, а сведения о конечной точке, такие как IP-адрес, порт и имя пользователя заносятся в базу данных регистрации. Когда пользователь выходит из системы, эти сведения удаляются из базы данных. Между входом в систему и выходом из нее Registrar поддерживает информацию о статусе в актуальном состоянии и помогает направлять сообщения пользователю и от него.

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

Командлет Remove-CsRegistrarConfiguration позволяет удалить настройки конфигурации Registrar, примененные в области сайта или службы. Обратите внимание, что этот командлет не удаляет компоненты Registrars; он просто удаляет настройки конфигурации, управляющие этими компонентами. Если эти настройки не существуют в области сайта или службы, управление компонентом Registrar осуществляется при помощи глобальных настроек.

Командлет Remove-CsRegistrarConfiguration можно также выполнить применительно к глобальным параметрам конфигурации регистратора. В этом случае, однако, параметры не удаляются, так как глобальные параметры не подлежат удалению. Вместо этого для всех свойств в такой глобальной коллекции будут восстановлены их значения по умолчанию. Например, если для свойства MinEndpointExpiration было задано значение 500, будет восстановлено значение 300.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Обратите внимание на то, что командлет Remove-CsRegistrarConfiguration также можно выполнить применительно к глобальным параметрам (-Identity global). Однако в этом случае глобальные параметры не будут удалены. Вместо этого для всех свойств в такой глобальной коллекции будут восстановлены их значения по умолчанию.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings. Командлет Remove-CsRegistrarConfiguration принимает из конвейера экземпляры объекта параметров регистратора.

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

 
Показ: