New-CsRegistrarConfiguration

Skype for Business Server 2015
 

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

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

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

В примере 1 создается новая коллекция настроек конфигурации компонентов Registrar для сайта Redmond (-Identity site:Redmond). Кроме задания идентификатора Identity для новых настроек, команда также задает максимальное число конечных точек для пользователя равным 4 (-MaxEndpointsPerUser 4) и разрешает использование DHCP-сервера для регистрации клиента (-EnableDHCPServer $True). Обратите внимание, что эта команда закончится неудачей, если сайту Redmond уже назначена коллекция настроек конфигурации компонентов Registrar.

New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True

Команды, показанные в примере 2, также создают новую коллекцию настроек конфигурации компонентов Registrar для сайта Redmond (-Identity site:Redmond). Но в этом примере настройки первоначально создаются только в памяти, а позднее применяются к самому сайту.

Для выполнения этой задачи в первой команде используется командлет New-CsRegistrarConfiguration , который создает новую коллекцию параметров для site:Redmond. В конец команды добавлен параметр InMemory, чтобы гарантировать создание этих параметров только в памяти, без немедленного применения к сайту Redmond. Так как эти параметры существуют только в памяти, они должны храниться в переменной. В данном примере это переменная $x.

В командах 2 и 3 изменяются два свойства этих новых виртуальных параметров (MaxEndpointsPerUser и EnableDHCPServer). Затем последняя команда в примере с помощью командлета Set-CsRegistrarConfiguration преобразует виртуальные параметры, хранящиеся в $x, в фактический набор параметров конфигурации регистратора применяемый к сайту Redmond. Без вызова командлета Set-CsRegistrarConfiguration никакие новые параметры для сайта Redmond созданы не будут, а виртуальные параметры исчезнут сразу же после завершения текущего сеанса Windows PowerShell или удаления переменной $x.

$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory 
$x.MaxEndpointsPerUser = 4 
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x

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

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

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

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Кроме того, новые настройки компонентов Registrar нельзя сохранить на глобальном уровне. Если нужно изменить значения на глобальном уровне, используйте командлет 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-серверы, чтобы найти компонент Registrar. При значении True клиенты будут отправлять сообщение DHCP Inform при первом запуске. DHCP-сервер ответит, отправляя полное доменное имя (FQDN) компонента Registrar, которое может использоваться для входа пользователя в систему.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

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

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

Active

FailedOver

FailingOver

FailedBack

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: