Set-CsRegistrarConfiguration
上一次修改主题: 2012-03-26
修改现有的注册器配置设置集合中的属性值。注册器用于对登录请求进行身份验证并维护有关用户状态和可用性的信息。
语法
Set-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]
Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]
详细说明
注册器可能是 Microsoft Lync Server 2010 中最重要的组件;总而言之,如果没有注册器,用户将无法登录到系统,并且 Lync Server 2010 将无法跟踪用户及其当前状态。当用户登录到 Lync Server 时,用户登录所采用的终结点将向注册器发送一条 REGISTER 请求;反过来,该服务器会通过向客户端设备质询身份验证凭据来进行响应。如果客户端通过此质询(即,如果客户端提供了一组有效的凭据),该用户则通过身份验证,并且系统会将 IP 地址、端口和用户名等终结点信息记录到注册数据库中。当用户注销时,将从数据库中删除此信息。在登录和注销之间,注册器会更新状态信息,并帮助路由往返于用户的消息。
注册器配置设置用于帮助管理终结点和终结点订阅;这些设置可应用于 global 作用域、site 作用域或 service 作用域。(在 Service 作用域应用的设置只能用于 Registrar 服务。)Set-CsRegistrarConfiguration cmdlet 可用于修改组织中当前使用的任何(或所有)注册器配置集合。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsRegistrarConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrarConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的注册器配置设置的唯一标识符。要修改全局设置,请使用以下语法:-Identity global。要修改在 site 作用域配置的设置,请使用以下类似语法:-Identity site:Redmond。要修改服务级别的设置,请使用以下类似语法:-Identity service:Registrar:atl-cs-001.litwareinc.com。请注意,只能将注册器设置应用于 Registrar 服务。如果试图将这些设置应用于任何其他服务,则会生成错误消息。 |
Instance |
可选 |
RegistrarSettings 对象 |
允许您将对对象的引用传递到 cmdlet,而不是设置单个参数值。 |
DefaultEndpointExpiration |
可选 |
整数 |
终结点在登录时可选择请求到期超时;这将指定终结点在与服务器联系并请求延时之前可保持登录到系统的时间间隔。DefaultEndpointExpiration 属性表示未请求具体超时值的客户端的到期超时时间间隔。 DefaultEndpointExpiration 必须介于 300(5 分钟)和 900(15 分钟)之间。默认值为 600(10 分钟)。 |
EnableDHCPServer |
可选 |
布尔值 |
指示终结点是否可以使用 DHCP 服务器查找注册器。如果设置为 True,客户端将在首次启动时发送一条 DHCP 通知消息;DHCP 服务器将通过发送用户可登录到的注册器的完全限定域名 (FQDN) 来进行响应。 |
MaxEndpointExpiration |
可选 |
整数 |
终结点在登录时可选择请求到期超时;这将指定终结点在与服务器联系并请求延时之前可保持登录到系统的时间间隔。MaxEndpointExpiration 属性表示可向客户端授予的最长时间。例如,如果最长时间设置为 600 秒,而客户端请求的超时时间间隔为 800 秒,系统将为该客户端指定允许的最长到期时间:600 秒。 MaxEndpointExpiration 必须介于 300(5 分钟)和 900(15 分钟)之间。默认值为 900。 |
MaxEndpointsPerUser |
可选 |
整数 |
指示用户可同时连接到系统的最大终结点数目。例如,使用计算机和移动电话登录到 Lync Server 2010 的用户将使用两个终结点。MaxEndPointsPerUser 必须设置为 1 到 64(包含边界值)之间的值。默认值为 8。 |
MinEndpointExpiration |
可选 |
整数 |
终结点在登录时可选择请求到期超时;这将指定终结点在与服务器联系并请求延时之前可保持登录到系统的时间间隔。MinEndpointExpiration 属性表示可向客户端授予的最短时间。例如,如果最短时间设置为 600 秒,而客户端请求的超时时间间隔为 200 秒,系统将为该客户端指定允许的最短到期时间:600 秒。 MinEndpointExpiration 必须介于 300(5 分钟)和 900(15 分钟)之间。默认值为 300。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 对象。Set-CsRegistrarConfiguration 接受通过管道传递的注册器设置对象的实例。
返回类型
Set-CsRegistrarConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True
上述命令修改应用于 Redmond 站点 (-Identity site:Redmond) 的注册器配置设置。在此示例中,EnableDHCPServer 属性的值设置为 True。
-------------------------- 示例 2 --------------------------
Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8} | Set-CsRegistrarConfiguration -MaxEndpointsPerUser 8
在示例 2 中,将修改允许用户使用 8 个以上的终结点的所有注册器配置设置。为执行此操作,该命令首先调用不带任何参数的 Get-CsRegistrarConfiguration;这将返回组织中使用的所有注册器配置设置的集合。然后,将该集合通过管道传递到 Where-Object,后者将仅挑选出 MaxEndpointsPerUser 属性大于 (-gt) 8 的设置。最后,将筛选出的集合通过管道传递到 Set-CsRegistrarCollection,后者会将集合中的每一项的最大终结点数目设置为 8。
-------------------------- 示例 3 --------------------------
Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False
示例 3 中显示的命令通过对组织中托管注册器配置设置集合的每个站点使用 DHCP 来禁用客户端注册。为执行此操作,该命令调用带有 Filter 参数的 Get-CsRegistrarConfiguration;参数值“site:*”将返回的数据限制为在 site 作用域配置的设置。然后,将该集合通过管道传递到 Set-CsRegistrarConfiguration,后者会使用 EnableDHCPServer 参数和参数值 $False 来阻止客户端使用 DHCP 服务器查找注册器。