New-CsWebServiceConfiguration
上一次修改主题： 2012-04-23
创建新的 Web 服务配置设置集合。
语法
New-CsWebServiceConfiguration -Identity <XdsIdentity> [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-InMemory <SwitchParameter>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
详细说明
许多 Microsoft Lync Server 2010 组件都基于 Web：这些组件使用 Web 服务或网页来执行其任务。例如，用户在通讯簿中搜索新联系人，或者通过组扩展来查看通讯组的各个成员时，可以使用 Web 服务。同样，范围从电话拨入式会议到 Microsoft Lync Server 2010 控制面板 的组件可使用网页作为 Lync Server 2010 与用户之间的界面。
通过 CsWebServiceConfiguration cmdlet，管理员可以管理整个组织中的 Web 服务配置设置。这包括管理组扩展、证书设置和允许的身份验证方法。由于您可以在 global、site 和 service 作用域（但仅限 Web Services 服务）配置不同的设置，因此可以为各个用户和各个位置自定义 Web 服务功能。
新的 Web 服务配置设置是使用 New-CsWebServiceConfiguration cmdlet 创建的。请注意，只能在 site 作用域或 service 作用域（仅适用于 Web Services 服务）创建这些设置；如果您尝试在 global 作用域创建新集合，则命令将失败。同样，如果您尝试在 Redmond 站点创建新集合，而该站点已托管了一个 Web 服务设置集合，则命令也将失败。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsWebServiceConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsWebServiceConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要创建的 Web 服务配置设置的唯一标识符。要创建在 site 作用域配置的设置，请使用以下类似语法：-Identity "site:Redmond"。要创建在 service 作用域配置的设置，请使用以下类似语法：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。请注意，所有在 service 作用域创建的设置都必须分配给 Web 服务器服务。 |
AllowAnonymousAccessToLWAConference |
可选 |
布尔值 |
设置为 True（默认值）时，允许匿名用户参加 Lync Web App (LWA) 会议。 |
CASigningKeyLength |
可选 |
整数 |
设置证书颁发机构 (CA) 签名密钥的大小，该密钥是 CA 用于对数字证书签名的私钥。签名密钥长度可以设置为 2048 到 16384 字节之间的任意整数值；默认值为 2048。 |
DefaultValidityPeriodHours |
可选 |
整数 |
使用证书身份验证时，客户端可以请求证书保持有效的时间长度（小时）。DefaultValidityPeriodHours 表示当客户端没有请求自定义有效期时，证书将保持有效的时间长度。 DefaultValidityPeriodHours 可以是 8 到 8760 小时（365 天）之间的任意整数值。默认值为 4320（180 天）。 |
EnableCertChainDownload |
可选 |
布尔值 |
如果设置为 True，则为其提供了身份验证证书的服务器将下载该证书的证书链。证书链可追溯单个证书的 CA。如果证书的 CA 不受信任，将不会接受该证书用于身份验证。 |
EnableGroupExpansion |
可选 |
如果设置为 True，则会在 Microsoft Lync 2010 中启用组扩展。使用组扩展，用户可以将通讯组配置为联系人，然后“扩展”该组。扩展一个组后，用户可以看到该组的所有单个成员及其当前状态信息。 |
|
InferCertChainFromSSL |
可选 |
布尔值 |
如果设置为 True，则服务器将使用安全套接字层 (SSL) 协议中包含的证书信息来确定证书颁发机构。如果证书的 CA 不受信任，将不会接受该证书用于身份验证。 |
MACResolverUrl |
可选 |
字符串 |
能够执行媒体访问控制 (MAC) 解析的 Web 服务的 URL。MAC 解析包括获取 IP 地址，并确定与该 IP 地址关联的网卡的 MAC 地址。 |
MaxCSRKeySize |
可选 |
整数 |
设置证书签名请求 (CSR) 密钥的最大大小。（CSR 是从申请人发送给 CA 的消息，旨在申请数字证书。）最大大小可以设置为 1024 到 16384 字节之间的任意整数值。默认值为 16384。 |
MaxGroupSizeToExpand |
可选 |
整数 |
表示当扩展组后将显示的最大人员数。例如，如果 MaxGroupSizeToExpand 设置为 75，则每次展开该组时，只会显示前 75 个组成员。 MaxGroupSizeToExpand 可以设置为 1 到 1000（包含边界值）之间的任意整数值。默认值为 100。 |
MaxValidityPeriodHours |
可选 |
整数 |
使用证书身份验证时，客户端可以请求证书保持有效的时间长度（小时）。MaxValidityPeriodHours 表示客户端可以请求的最长时间。 MaxValidityPeriodHours 可以是 8 到 8760 小时（365 天）之间的任意整数值。默认值为 8760。 |
MinCSRKeySize |
可选 |
整数 |
设置 CSR 密钥的最小大小。最小大小可以设置为 1024 到 16384 字节之间的任意整数值。默认值为 16384。 |
MinValidityPeriodHours |
可选 |
整数 |
使用证书身份验证时，客户端可以请求证书保持有效的时间长度（小时）。MinValidityPeriodHours 表示客户端可以请求的最短时间。 MinValidityPeriodHours 可以是 8 到 4320 小时（180 天）之间的任意整数值。默认值为 8。 |
SecondaryLocationSourceUrl |
可选 |
字符串 |
可以处理位置请求的 Web 服务的 URL。通常，仅当无法在本地解析位置请求时才会使用此服务。 |
ShowDownloadCommunicatorAttendeeLink |
可选 |
字符串 |
如果设置为 True（默认值），则当通过客户端应用程序而非 Lync 2010 加入会议时，用户会看到一个指向下载 Lync 2010 Attendee 的链接。 |
ShowJoinUsingLegacyClientLink |
可选 |
字符串 |
如果设置为 True，则当通过客户端应用程序而非 Lync 2010 加入会议时，用户可使用其当前客户端应用程序加入会议。默认值为 False。 |
TrustedCACerts |
可选 |
证书集合 |
表示 Web 服务器信任的证书链的证书集合。必须使用 New-CsWebTrustedCACertificate cmdlet 创建将添加到集合中的新证书。 如果 InferCertChainFromSSL 属性设置为 True，则不会使用此集合。 |
UseCertificateAuth |
可选 |
布尔值 |
设置为 True（默认值）时，可使用证书对客户端进行身份验证。将该值设置为 False ($False) 可禁用证书身份验证。 |
UsePinAuth |
可选 |
布尔值 |
设置为 True（默认值）时，可使用个人标识号 (PIN) 对客户端进行身份验证。将该值设置为 False ($False) 可禁用 PIN 身份验证。 |
UseWindowsAuth |
可选 |
PS 列表修饰符 |
确定用户如何（以及是否）使用 Windows 身份验证进行验证；即，使用他们登录到 Windows 时使用的凭据进行验证。有效值是： 协商 – 客户端与服务器将共同合作确定合适的身份验证协议（Kerberos 或 NTLM）。 NTLM – 允许进行 Windows 身份验证，但只能使用 NTLM 协议。 无 – 不允许进行 Windows 身份验证。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsWebServiceConfiguration 不接受通过管道传递的输入。
返回类型
New-CsWebServiceConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $False -UseCertificateAuth $True
示例 1 中显示的命令为 Redmond 站点 (-Identity site:Redmond) 创建新的 Web 服务配置设置集合。此示例包括两个可选参数：EnableGroupExpansion，设置为 False ($False)；以及 UseCertificateAuth，设置为 True ($True)。这两个参数分别用于禁用组扩展和启用证书身份验证。
请注意，如果已经为 Redmond 站点创建了一个 Web 服务配置设置集合，则该命令将失败。这是因为站点只能有一个 Web 服务配置设置集合。
-------------------------- 示例 2 --------------------------
$x = New-CsWebServiceConfiguration -Identity site:Redmond -InMemory
$x.EnableGroupExpansion = $False
$x.UseCertificateAuth = $True
Set-CsWebServiceConfiguration -Instance $x
示例 2 是示例 1 中显示的命令的变体；但在此示例中，新的 Web 服务配置设置集合最初只是在内存中创建的，后来才应用于 Redmond 站点。为此，示例中的第一个命令使用 New-CsWebServiceConfiguration 为 Redmond 站点创建一个设置集合；包含 InMemory 参数是为了确保仅在内存中创建该集合，并且不会将其立即应用于 Redmond 站点。（由于设置仅存在于内存中，因此必须在变量中存储这些设置。在此示例中，该变量名为 $x。）
示例中的命令 2 和 3 接受这些虚拟配置设置，并修改 EnableGroupExpansion 和 UseCertificateAuth 属性的值。在进行了这些更改后，最后一个命令使用 Set-CsWebServiceConfiguration 接受虚拟设置并将其应用于 Redmond 站点。如果未调用 Set-CsWebServiceConfiguration，则不会将任何新设置分配给该站点。一旦终止 Windows PowerShell 会话或删除变量 $x，虚拟 Web 服务配置设置将立即消失。