Set-CsRegistrarConfiguration

Skype for Business Server 2015
 

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

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

Set-CsRegistrarConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsRegistrarConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-BackupStoreUnavailableThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MaxUserCount <UInt64>] [-MinEndpointExpiration <Int32>] [-PoolState <FailedOver | Active | FailingOver | FailingBack>] [-WhatIf [<SwitchParameter>]]

В примере 1 изменяются параметры конфигурации регистратора, применяемые к узлу Redmond (-Identity site:Redmond). В этом примере свойству EnableDHCPServer присвоено значение True.

Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True

В примере 2 изменяются все параметры конфигурации регистратора, допускающие для пользователей более 8 конечных точек. Для этого сначала вызывается командлет Get-CsRegistrarConfiguration без параметров, который возвращает коллекцию всех параметров конфигурации регистратора, используемых в организации. Эта коллекция передается в командлет Where-Object , который выбирает только те параметры, свойство MaxEndpointsPerUser которых больше (-gt) 8. Наконец, отфильтрованная коллекция передается в командлет Set-CsRegistrarConfiguration , задающий для каждого из элементов в коллекции максимальное число конечных точек, равное 8.

Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8} | Set-CsRegistrarConfiguration -MaxEndpointsPerUser 8

Команда, показанная в примере 3, отключает регистрацию клиентов по протоколу DHCP для каждого сайта в организации, на котором присутствует коллекция параметров конфигурации регистратора. Для этого вызывается командлет Get-CsRegistrarConfiguration с параметром Filter; значение параметра, "site:*", ограничивает возвращаемые данные параметрами, настроенными для области сайта. Эта коллекция передается в командлет Set-CsRegistrarConfiguration , который использует параметр EnableDHCPServer со значением $False, чтобы запретить клиентам использовать DHCP-сервер для обнаружения регистратора.

Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False

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

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

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

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

 

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

BackupStoreUnavailableThreshold

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

System.TimeSpan

Определяет время ожидания в системе перед определением доступности резервного хранилища; при этом пользователи будут переведены в режим жизнеспособности. Значение по умолчанию — 30 минут (00:30:00).

Confirm

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

System.Management.Automation.SwitchParameter

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

DefaultEndpointExpiration

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

System.Int32

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

Значение DefaultEndpointExpiration должно быть в диапазоне от 300 (5 минут) до 900 (15 минут). Значение по умолчанию — 600 (10 минут).

EnableDHCPServer

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

System.Boolean

Указывает, разрешается ли конечным точкам использовать DHCP-серверы для нахождения регистратора. Значение True разрешает клиентам отправлять сообщение DHCPInform при первом своем запуске. DHCP-сервер ответит, отправив полное доменное имя (FQDN) регистратора, который может использоваться в ходе обработки запроса на вход в систему от пользователя.

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Instance

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

Объект RegistrarSettings

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

MaxEndpointExpiration

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

System.Int32

При выполнении входа конечные точки могут запросить срок действия сеанса (период, по истечении которого конечная точка должна связаться с сервером и запросить продление, чтобы остаться в системе). Свойство MaxEndpointExpiration представляет максимальный период времени, который может быть предоставлен клиентам. Например, если указано значение в 600 секунд, а клиент запрашивает 800 секунд, ему будет предоставлен максимально возможный период, т. е. 600 секунд.

Значение MaxEndpointExpiration должно быть в диапазоне от 300 (5 минут) до 900 (15 минут). Значение по умолчанию — 900.

MaxEndpointsPerUser

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

System.UInt16

Указывает максимальное число одновременно подключенных к системе конечных точек, разрешенное для пользователя. Например, пользователь, вошедший в систему Skype для бизнеса Server 2015 как с компьютера, так и мобильного телефона, будет использовать две конечных точки. Свойству MaxEndPointsPerUser должно быть присвоено значение в диапазоне от 1 до 64, включительно. Значение по умолчанию — 8.

Хотя пользователю может быть разрешено использование до 64 конечных точек, рекомендуется, чтобы максимальное количество конечных точек не превышало 8. Значения 9 или более используются для обратной совместимости, а также (в отдельных случаях) по предложению персонала технической поддержки Майкрософт. Для новых развертываний максимальное количество конечных точек не должно превышать 8.

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

MaxUserCount

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

System.UInt64

Указывает максимальное количество пользователей, которые могут одновременно выполнить вход в пул регистратора. Параметру MaxUserCount может быть задано любое целое значение в диапазоне от 2000 до 100000 включительно. Значением по умолчанию является 12000.

MinEndpointExpiration

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

System.Int32

При выполнении входа конечные точки могут запросить срок действия сеанса (период, по истечении которого конечная точка должна связаться с сервером и запросить продление, чтобы остаться в системе). Свойство MinEndpointExpiration представляет минимальный период времени, который может быть предоставлен клиентам. Например, если указано значение в 600 секунд, а клиент запрашивает 200 секунд, ему будет предоставлен минимально возможный период, т. е. 600 секунд.

Значение MinEndpointExpiration должно быть в диапазоне от 300 (5 минут) до 900 (15 минут). Значение по умолчанию — 300.

PoolState

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

Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.PoolState

Текущее состояние пула регистраторов. Допустимые значения:

* Active

* FailedOver

* FailingOver

* FailedBack

Значение по умолчанию — Active.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: