Set-CsRegistrar
上一次修改主题: 2012-03-26
用于修改一个或多个注册器的属性。注册器用于对登录请求进行身份验证并维护有关用户状态和可用性的信息。
语法
Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
详细说明
注册器可能是 Microsoft Lync Server 2010 中最重要的组件;如果没有注册器,用户将无法登录到系统,并且 Lync Server 2010 将无法跟踪用户及其当前状态。当用户登录到 Lync Server 时,用户登录所采用的终结点(可能为计算机、移动电话或某种其他设备)将向注册服务器发送一条 REGISTER 请求;反过来,该服务器会通过向客户端设备质询身份验证凭据来进行响应。如果客户端通过此质询(即,如果客户端提供了一组有效的凭据),该用户则通过身份验证,并且系统会将 IP 地址、端口和用户名等终结点信息记录到注册数据库中。当用户注销时,将从数据库中删除此信息。在登录和注销之间,注册器会更新状态信息,并帮助路由往返于用户的消息。
Set-CsRegistrar cmdlet 提供了一种用于修改组织中的一个或多个注册器的属性的方法。这些修改包括更改端口设置,以及指定在注册器变得不可用时应采取的操作。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsRegistrar cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrar\b"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的注册器的服务位置。例如:-Identity "Registrar:atl-cs-001.litwareinc.com"。 请注意,指定注册器时,可以省略前缀“Registar:”。例如:-Identity "atl-cs-001.litwareinc.com"。 |
ArchivingServer |
可选 |
字符串 |
要与注册器关联的存档服务器的服务位置。例如:-ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com"。 |
BackupRegistrar |
可选 |
字符串 |
此注册器不可用时要使用的注册器的服务位置。例如:-BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com"。 |
EdgeServer |
可选 |
字符串 |
要与注册器关联的边缘服务器的服务位置。例如:-EdgeServer "EdgeServer:atl-edge-001.litwareinc.com"。 |
EnableAutomaticFailover |
可选 |
布尔值 |
如果设置为 True,则只要主注册器不可用,就将使用备份注册器。如果设置为 False,则当主注册器不可用时,将不使用备份注册器。 此参数还影响已在备份注册器中注册的用户。如果此参数设置为 True,则当主注册器变得可用时,将从备份注册器中删除这些用户并在主注册器中重新注册他们。 |
FailbackDetectionInterval |
可选 |
TimeSpan |
指定系统在检查之前变得不可用的注册器现在是否可用之前将等待的时间。如果已将 EnableAutomaticFailover 设置为 True,则每次注册器变得不可用时,系统都会“故障转移”到备份注册器。这就意味着,系统将选取登录到发生故障的注册器的用户,并尝试使他们登录到备份注册器。 FailbackDetectionInterval 属性指定了系统在检查原始注册器是否再次可用之前将等待的时间。如果可用,则 Lync Server 将尝试“故障回复”到该注册器。故障回复就是指还原为最初使用的注册器;也就是说,使用户重新登录到他们的原始注册器。 请注意,故障回复只是一个自动过程。您无法手动从一个注册器故障回复到另一个注册器。 检测时间间隔可设置为 30 秒到 84,400 秒(24 小时)之间的任何值;使用“小时:分钟:秒”格式指定时间段。例如,以下命令将时间间隔设置为 1 小时 15 分钟:- FailbackDetectionInterval 01:15:00。 除非指定了备份注册器,否则不能使用此参数。 |
FailureDetectionInterval |
可选 |
TimeSpan |
指定系统在确定某个注册器不可用之前将等待的时间间隔。如果已将 EnableAutomaticFailover 设置为 True,则系统将尝试使用户登录到备份注册器。 检测时间间隔可设置为 30 秒到 84,400 秒(24 小时)之间的任何值;使用“小时:分钟:秒”格式指定时间段。例如,以下命令将时间间隔设置为 1 小时 15 分钟:- FailureDetectionInterval 01:15:00。 除非指定了备份注册器,否则不能使用此参数。 |
MonitoringServer |
可选 |
字符串 |
要与注册器关联的监控服务器的服务位置。例如:-MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com"。 |
Registrar |
可选 |
字符串 |
注册器的服务位置。 |
SipPort |
可选 |
整数 |
用于 SIP(会话初始协议)流量的端口。 |
SipHealthPort |
可选 |
字符串 |
用于监视服务器运行状况的端口。 |
SipServerTcpPort |
可选 |
字符串 |
SIP 侦听端口。默认值为 5060。 |
UserServer |
可选 |
字符串 |
要与注册器关联的用户服务服务器的服务位置。例如:-UserServer "UserServer:atl-cs-001.litwareinc.com"。 |
WebPort |
可选 |
整数 |
用于与 Web 服务器通信的端口。 |
WebServer |
可选 |
字符串 |
要与注册器关联的 Web 服务器的服务位置。例如:-WebServer "WebServer:atl-cs-001.litwareinc.com"。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsRegistrar 不接受通过管道传递的输入。
返回类型
Set-CsRegistrar 不会返回任何对象或值。此命令会修改 Microsoft.Rtc.Management.Xds.DisplayRegistrar 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
示例 1 中显示的命令将注册器 Registrar:atl-cs-001.litwareinc.com 的 SIP 端口设置为 5072。
-------------------------- 示例 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
上述命令将组织中所有注册器的 SIP 端口设置为 5072。为执行此操作,该命令首先使用 Get-CsService 和 Registrar 参数返回当前使用的所有注册器的集合。然后,将该集合通过管道传递到 ForEach-Object cmdlet,后者将选取集合中的每个注册器,并运行 Set-CsRegistrar cmdlet,以便将 SIP 端口更改为 5072。
-------------------------- 示例 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
示例 3 为注册器 Registrar:atl-cs-001.litwareinc.com 配置备份注册器 (BackupRegistrar) 和自动故障转移 (EnableAutomaticFailover)。