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