Set-CsDirector
上一次修改主题： 2012-03-27
修改一个或多个控制器的属性。控制器可用于对用户请求进行身份验证，但不会承载用户帐户。
语法
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
详细说明
控制器可对用户进行身份验证并响应用户请求，但不会实际托管用户帐户。控制器通常用于允许通过边缘服务器对网络进行外部访问的组织。在该方案中，控制器不仅能够帮助减少前端服务器的压力（通过处理身份验证请求），而且可以帮助内部网络抵御拒绝服务攻击，并免遭其他恶意流量的影响。在中心站点部署多个前端服务器时，控制器也很有用。在这种情况下，控制器将接收所有用户请求，然后将这些请求通过信道传递到相应的服务器池。它还能够帮助减轻前端服务器的压力。
通过 Set-CsDirector cmdlet，您可以修改组织中当前使用的所有控制器的属性值。这包括更改与控制器关联的存档服务器或边缘服务器等，或者更改用于发送和接收 SIP 流量的端口。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsDirector cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDirector"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的控制器的服务位置。例如：-Identity "Director:atl-cs-001.litwareinc.com"。 请注意，指定控制器时，可以省略前缀“Director:”。例如：-Identity "atl-cs-001.litwareinc.com"。 |
ArchivingServer |
可选 |
字符串 |
要与控制器关联的存档服务器的服务位置。例如：-ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com"。 |
EdgeServer |
可选 |
字符串 |
要与控制器关联的边缘服务器的服务位置。例如：-EdgeServer "EdgeServer:atl-edge-001.litwareinc.com" |
MonitoringServer |
可选 |
字符串 |
要与控制器关联的监控服务器的服务位置。例如：-MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com"。 |
SipPort |
可选 |
整数 |
用于会话初始协议 (SIP) 流量的端口。 |
SipHealthPort |
可选 |
整数 |
用于监视服务器运行状况的端口。 |
SipServerTcpPort |
可选 |
整数 |
SIP 侦听端口。默认值为 5060。 |
WebPort |
可选 |
整数 |
用于与 Web 服务通信的端口。 |
WebServer |
可选 |
字符串 |
要与控制器关联的服务器的 Web 服务位置。例如：-WebServer "WebServer:atl-cs-001.litwareinc.com" |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsDirector 不接受通过管道传递的输入。
返回类型
Set-CsDirector 不会返回任何对象或值。但此 cmdlet 会修改 Microsoft.Rtc.Management.Xds.DisplayDirector 对象的现有实例。
示例
-------------------------- 示例 1 ------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
示例 1 中显示的命令将更改与控制器 Director:atl-cs-001.litwareinc.com 关联的存档服务器。在此示例中，存档服务器将切换到 ArchivingServer:dublin-cs-001.litwareinc.com。
-------------------------- 示例 2 ------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
上述命令将更改组织中当前使用的所有控制器的 SIP 端口。要执行此操作，命令首先使用 Get-CsService 和 Director 参数返回组织中所有控制器的集合。然后将该集合通过管道传递到 ForEach-Object。接下来，ForEach-Object 将针对集合中的每个站点运行 Set-CsDirector，将 SipPort 属性的值更改为 5072。