Set-CsRegistrar

Skype for Business Server 2015
 

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

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

Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingDatabase <String>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-LyssWcfMtlsPort <UInt16>] [-MirrorArchivingDatabase <String>] [-MirrorMonitoringDatabase <String>] [-MonitoringDatabase <String>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]] [-WinFabClientConnectionPort <UInt16>] [-WinFabFederationPort <UInt16>] [-WinFabIPCPort <UInt16>] [-WinFabLeaseAgentPort <UInt16>] [-WinFabReplicationPort <UInt16>] [-XmppGatewaySipPort <UInt16>]

Команда, показанная в примере 1, устанавливает для регистратора Registrar:atl-cs-001.litwareinc.com порт SIP 5072.

Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072

В примере 2 для всех регистраторов в организации задается порт SIP 5072. Для этого сначала с помощью командлета Get-CsService и параметра Registrar извлекается коллекция всех используемых в текущий момент регистраторов. Затем эта коллекция передается командлету ForEach-Object , который принимает каждый параметр Registrar из коллекции и запускает командлет Set-CsRegistrar , чтобы изменить SIP-порт на 5072.

Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}

В примере 3 настраивается резервный регистратор (BackupRegistrar) и автоматическая отработка отказа (EnableAutomaticFailover) для регистратора Registrar:atl-cs-001.litwareinc.com.

Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True

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

Командлет Set-CsRegistrar обеспечивает способ изменения свойств одного или нескольких регистраторов в организации. Например, это может быть изменение параметров порта, а также указание действия, которое должно выполняться в случае, если регистратор становится недоступным.

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

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

 

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

ArchivingDatabase

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

System.String

Удостоверение службы базы данных, используемое службой архивации Archiving Service.

ArchivingServer

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

System.String

Расположение службы сервера архивации, которая должна быть связана с регистратором. Например: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com".

BackupRegistrar

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

System.String

Расположение службы регистратора, который должен использоваться, если данный регистратор недоступен. Например: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com".

Confirm

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

System.Management.Automation.SwitchParameter

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

EdgeServer

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

System.String

Расположение службы пограничного Пограничный сервера, который должен быть связан с регистратором. Например: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com".

EnableAutomaticFailover

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

System.Boolean

Если установлено значение True, то резервный регистратор будет использоваться всякий раз, когда недоступен основной регистратор. Если установлено значение False, то резервный регистратор не будет использоваться при недоступности основного регистратора.

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

FailbackDetectionInterval

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

System.TimeSpan

Задает промежуток времени, который система будет ожидать перед тем, как выполнить проверку, не стал ли доступным недоступный регистратор. Если параметр EnableAutomaticFailover установлен в значение True, то система будет автоматически переходить на резервный регистратор каждый раз, когда основной регистратор становится недоступным. Это просто означает, что система будет брать пользователей, вошедших через регистратор, который стал недоступным, и пытаться зарегистрировать их в резервном регистраторе.

Свойство FailbackDetectionInterval задает промежуток времени, который система будет ожидать, прежде чем выполнить проверку, не стал ли первоначальный регистратор снова доступным. Если стал, то Skype для бизнеса Server 2015 будет пытаться "восстановить размещение" на этом регистраторе. Восстановление размещения означает просто возврат в регистратор, который использовался первоначально; другими словами, регистрация пользователей возвращается в первоначальный регистратор.

Обратите внимание, что восстановление размещения может быть только автоматическим процессом. Вручную восстановить размещение с одного регистратора на другом невозможно.

В качестве промежутка времени для проверки может быть установлено любое значение от 30 секунд до 84 400 секунд (24 часов); указывайте этот промежуток в формате часы:минуты:секунды. Например, следующая установка задает промежуток времени в 1 час 15 минут: - FailbackDetectionInterval 01:15:00.

Данный параметр нельзя использовать без указания резервного регистратора.

FailureDetectionInterval

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

System.TimeSpan

Задает промежуток времени, который система будет ожидать, прежде чем решить, что регистратор недоступен. Если параметр EnableAutomaticFailover имеет значение True, то система будет затем пытаться зарегистрировать пользователей в резервном регистраторе.

В качестве промежутка времени для проверки может быть установлено любое значение от 30 секунд до 84 400 секунд (24 часов); указывайте этот промежуток в формате часы:минуты:секунды. Например, следующая установка задает промежуток времени в 1 час 15 минут: - FailureDetectionInterval 01:15:00.

Данный параметр нельзя использовать без указания резервного регистратора.

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

Расположение службы регистратора, который подлежит изменению. Например: -Identity "Registrar:atl-cs-001.litwareinc.com".

Следует отметить, что при задании регистратора префикс "Registrar:" можно не указывать. Например: -Identity "atl-cs-001.litwareinc.com".

LyssWcfMtlsPort

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

System.UInt16

Порт, используемый службой Lync Storage Service (LYSS). Значение по умолчанию ? 5077.

MirrorArchivingDatabase

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

System.String

Удостоверение службы зеркальной базы данных, используемой службой архивации.

MirrorMonitoringDatabase

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

System.String

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

MonitoringDatabase

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

System.String

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

MonitoringServer

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

System.String

Расположение службы сервера мониторинга, которая должна быть связана с регистратором. Например: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com".

Registrar

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

System.String

Расположение службы регистратора.

SipHealthPort

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

System.UInt16

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

SipPort

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

System.UInt16

Порт, используемый для трафика по протоколу SIP.

SipServerTcpPort

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

System.UInt16

Прослушивающий порт SIP. Значение по умолчанию ? 5060.

UserServer

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

System.String

Расположение службы сервера службы обслуживания пользователей, который должен быть связан с регистратором. Например: -UserServer "UserServer:atl-cs-001.litwareinc.com".

WebPort

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

System.UInt16

Порт, используемый для связи с веб-серверами.

WebServer

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

System.String

Расположение службы веб-сервера, который должен быть связан с регистратором. Например: -WebServer "WebServer:atl-cs-001.litwareinc.com".

WhatIf

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

System.Management.Automation.SwitchParameter

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

WinFabClientConnectionPort

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

System.UInt16

Порт, используемый для клиентских подключений к Windows Fabric. Значение по умолчанию ? 5092.

WinFabFederationPort

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

System.UInt16

Порт, используемый для федерации Windows Fabric. Федерация ссылается на процесс, посредством которого Windows Fabric маршрутизирует сообщения. Значение по умолчанию ? 5090.

WinFabIPCPort

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

System.UInt16

Порт, используемый Windows Fabric для межпроцессного взаимодействия. Межпроцессное взаимодействие ? это технология, позволяющая нескольким потокам в процессе обмениваться данными. Значение по умолчанию ? 5093.

WinFabLeaseAgentPort

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

System.UInt16

Порт, используемый агентом аренды Windows Fabric. Агенты аренды используются для взаимодействия с драйвером аренды на уровне ядра. Значение по умолчанию ? 5091.

WinFabReplicationPort

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

System.UInt16

Порт, используемый для репликации Windows Fabric. Skype для бизнеса Server 2015 использует Windows Fabric для репликации каталогов конференций на все серверы переднего плана в пуле регистратора. Значение по умолчанию: 5094.

XmppGatewaySipPort

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

System.UInt16

Порт, используемый шлюзом XMPP, связанным с регистратором. Расширяемый протокол XMPP ? это протокол передачи данных открытого стандарта для обмена сообщениями с использованием XML. Разрешенный партнер ? это поставщик услуг обмена мгновенными сообщениями и сведениями о присутствии, чьим пользователям разрешается обмен мгновенными сообщениями и сведениями о присутствии с вашими пользователями Skype для бизнеса Server 2015. Значение по умолчанию: 5098.

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

Командлет Set-CsRegistrar не возвращает объектов или значений. Вместо этого он изменяет существующие экземпляры объекта Microsoft.Rtc.Management.Xds.DisplayRegistrar.

 
Показ: