New-CsProxyConfiguration
上一次修改主题: 2012-03-26
创建新的代理配置设置集合。
语法
New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 用于通过代理服务器配置设置来管理代理服务器。这些设置可在 global 作用域和 service 作用域(但仅限边缘服务器和 Registrar 服务)应用,用于控制可供客户端终结点使用的身份验证协议以及是否将在传入和传出代理服务器连接上使用压缩等设置。当安装 Lync Server 2010 时,系统将自动为您创建代理服务器配置设置的全局集合。如前所述,您也可以在 service 作用域创建其他集合。这些新集合是使用 New-CsProxyConfiguration cmdlet 创建的。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsProxyConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsProxyConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
要创建的代理服务器配置设置的唯一标识符。只能在 service 作用域创建代理服务器配置设置,并且只能为 边缘服务器 和 Registrar 服务创建这些设置。无法在 global 作用域创建设置;同样,如果相关服务已托管代理服务器设置集合,则也无法在 service 作用域创建设置。例如,如果 Registrar:atl-cs-001.litwareinc.com 服务已托管代理服务器设置,则试图为该服务创建新设置的任何命令都将失败。 要为新的代理服务器设置指定 Identity,请使用以下类似语法:-Identity "service:Registrar:atl-cs-001.litwareinc.com"。 |
AcceptClientCompression |
可选 |
布尔值 |
设置为 True(默认值)时,代理服务器将接受来自客户端终结点的所有传入压缩请求。 |
AcceptServerCompression |
可选 |
布尔值 |
设置为 True(默认值)时,代理服务器将接受来自其他服务器的所有传入压缩请求。 |
DNSCacheRecordCount |
可选 |
整数 |
DNS 记录缓存中可以保留的最多记录数。默认值为 30000。 |
DisableNTLMFor2010AndLaterClients |
可选 |
布尔值 |
设置为 True 时,从 Microsoft Lync 2010 登录的用户必须使用 Kerberos 协议进行身份验证。默认值为 False。 |
EnableWhiteSpaceKeepAlive |
可选 |
布尔值 |
设置为 True(默认值)时,代理服务器要求客户端定期发送“空白消息”(没有内容的空消息),以指示其连接仍处于活动状态。 |
MaxClientCompressionCount |
可选 |
整数 |
指示可在任何给定时间压缩的客户端与服务器之间的连接的最大数目;将不会压缩超过此限制的其他连接。压缩计数可以设置为 0 到 65535(包含边界值)之间的任意整数值。默认值为 15000。 |
MaxClientMessageBodySizeKB |
可选 |
整数 |
从客户端终结点发送的消息正文的最大允许大小 (KB)。默认值为 128,这意味着正文大小超过 128 KB 的消息将被拒绝。客户端消息正文大小可以设置为 64 到 256(包含边界值)之间的任意整数值。 |
MaxServerCompressionCount |
可选 |
整数 |
指示可在任何给定时间压缩的服务器与服务器之间的连接的最大数目;将不会压缩超过此限制的其他连接。服务器压缩计数可以设置为 0 到 65535(包含边界值)之间的任意整数值。默认值为 1024。 |
MaxServerMessageBodySizeKB |
可选 |
整数 |
从其他服务器发送的消息正文的最大允许大小 (KB)。默认值为 5000,这意味着正文大小超过 5000 KB 的消息将被拒绝。服务器消息正文大小可以设置为 1000 到 20000(包含边界值)之间的任意整数值。 |
OutgoingTLSCount |
可选 |
整数 |
指定可以用于每个内部用户的传输层安全性 (TLS) 连接的最大数量。TLS 连接的最小数目为 1,最大数目为 4。默认情况下,OutgoingTlsCount 设置为 4。 |
Realm |
可选 |
SipProxy 对象 |
指示安全凭据是由默认的代理服务器领域(SIP 通信服务)处理还是由自定义领域处理。自定义领域必须使用 New-CsSipProxyCustom cmdlet 指定(和创建)。 |
RequestServerCompression |
可选 |
布尔值 |
设置为 True(默认值)时,代理服务器将请求在到其他服务器的所有传出连接上使用压缩。 |
TreatAllClientsAsRemote |
可选 |
布尔值 |
如果设置为 True,代理服务器将按照所有客户端连接均是通过运行访问边缘服务的边缘服务器传递的外部连接的方式运行。默认值为 False。 |
UseCertificateForClientToProxyAuth |
可选 |
布尔值 |
设置为 True(默认值)时,将允许客户端终结点使用证书进行身份验证。 |
UseKerberosForClientToProxyAuth |
可选 |
布尔值 |
设置为 True(默认值)时,将允许客户端终结点使用 Kerberos 协议进行身份验证。虽然 Kerberos 协议比 NTLM 协议更安全,但如果客户端与服务器隶属于不同的域,则不能使用 Kerberos 协议。 |
UseNtlmForClientToProxyAuth |
可选 |
布尔值 |
设置为 True(默认值)时,将允许客户端终结点使用 NTLM 协议进行身份验证。虽然 NTLM 协议不如 Kerberos 协议安全,但如果客户端与服务器隶属于不同的域,则可以使用 NTLM 协议。此情况不适用于 Kerberos 身份验证。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsProxyConfiguration 不接受通过管道传递的输入。
返回类型
New-CsProxyConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256
上述命令为服务 EdgeServer:atl-edge-001.litwareinc.com 创建新的代理配置设置集合。这些新设置使用除以下两项以外的所有默认代理服务器属性值:设置为 True 的 RequestServerCompression;以及设置为 256 的 MaxClientMessageBodySizeKb。请注意,如果已为服务 EdgeServer:atl-edge-001.litwareinc.com 配置代理服务器设置,此命令将失败。
-------------------------- 示例 2 --------------------------
$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x
示例 2 中显示的命令演示如何创建一个最初仅存在于内存中的代理服务器设置集合。为此,第一个命令调用带以下两个参数的 New-CsProxyConfiguration:Identity(指定设置标识)和 InMemory(指示应在内存中创建新设置)。生成的对象存储在变量 $x 中。
在创建了这些虚拟设置之后,第 2 和第 3 个命令分别用于修改 RequestServerCompression 和 MaxClientMessageBodySizeKb 属性的值。最后,使用命令 4 将虚拟代理服务器配置设置转换为在服务 EdgeServer:atl-edge-001.litwareinc.com 中应用的实际设置集合。最后一个命令是必需的。如果未调用 Set-CsProxyConfiguration,则不会将任何设置应用于 EdgeServer:atl-edge-001.litwareinc.com,而且一旦结束 Windows PowerShell 会话或删除变量 $x,虚拟设置也将立即消失。