New-CsMcxConfiguration

 

上一次修改主题： 2012-04-23

在 site 作用域或 service 作用域创建新的 Microsoft Lync Server 2010 Mobility Service 配置设置集合。Mobility Service 使移动电话（如 iPhone 和 Windows Phone）用户能够执行如下操作：交换即时消息和状态信息；在内部而不是使用其无线提供商存储和检索语音邮件；以及利用 Microsoft Lync Server 2010 功能（如通过工号拨号和电话拨出式会议）。

语法

New-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]

详细说明

Microsoft Lync Server 2010 Mobility Service 将 Microsoft Lync 2010 的许多功能扩展到移动设备（如 Apple iPhone、Windows Phone、Android 手机和 Nokia 手机）中。用户主要可以使用这些手机交换即时信息和状态信息，以及接收新语音邮件的通知。借助推送通知服务（Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务），即使 Lync 2010 在后台运行，使用 iPhone 或 Windows Phone 的用户也可以接收这些通知。Mobility Service 还为组织提供了实现通过工号拨号的机会。凭借通过工号拨号，用户可以从其移动电话发起呼叫，并使其显示为来自其工作电话的呼叫；例如，来电显示系统将显示用户的工作号码，而不是其移动电话号码。

Mobility Service 本身可以通过使用移动服务配置设置进行管理。这些设置可应用于 global 作用域、site 作用域或 service 作用域（仅限 Web 服务器服务），用于控制以下事项：Mobility Service 会话的最长时间；Microsoft Lync Server 2010 自动发现服务（将 Mobility Service 用户定向到相应的注册器池）是否对从组织的防火墙之外登录的用户可用；以及推送通知服务提供商的位置。

安装 Lync Server 2010 时，将在 global 作用域创建一个 Mobility Service 配置设置的集合；但是，管理员可以使用 New-CsMcxConfiguration cmdlet 在 site 作用域或 service 作用域创建自定义配置设置。

谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsMcxConfiguration cmdlet：RTCUniversalServerAdmins。

参数

参数	必需	类型	描述
Identity	必需	Xds 标识	要创建的 Mobility Service 配置设置集合的唯一标识符。要在 site 作用域创建设置，请使用前缀“site:”，后跟站点名称。例如： -Identity "site:Redmond" 要创建在 service 作用域配置的设置，请使用以下类似语法： -Identity service:WebServer:atl-cs-001.litwareinc.com
ExposedWebURL	可选	ExposedWebURL object	指示自动发现服务使用的 URL 是可由组织防火墙内部和外部的用户访问 (External)，还是只能由防火墙内部的用户访问 (Internal)。 允许的值包括：Internal 或 External。默认值为 External。
PushNotificationProxyUri	可选	字符串	可将推送通知请求转发到 Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务的服务提供商的 URI。PushNotificationProxyUri 必须采用 SIP 地址的格式；例如： -PushNotificationProxyUri "sip:push@push.lync.com"
SessionExpirationInterval	可选	整数	IPhone 或 Widows Phone 用户的移动会话的时长（以秒为单位）。如果在这些电话上 Lync 2010 在后台运行，则只要会话有效期未结束，用户就会收到推送通知。 达到会话超时时间之前，移动设备必须向服务器发送一则通知，指示设备仍处于活动状态。否则，设备将被列为不活动，用户将必须重新登录系统。 此属性可以设置为 120 到 4294967295（包含边界值）之间的任何整数值。默认值为 259200 秒（3 天）。注意，SessionExpirationInterval 属性的值必须大于 SessionShortExpirationInterval 属性的值。
SessionShortExpirationInterval	可选	整数	Android 或 Nokia 手机用户的移动会话的时长（以秒为单位）。 达到会话超时时间之前，移动设备必须向服务器发送一则通知，指示设备仍处于活动状态。否则，设备将被列为不活动，用户将必须重新登录系统。 此属性可以设置为 120 到 4294967295（包含边界值）之间的任何整数值。默认值为 259200 秒（3 天）。注意，SessionExpirationInterval 属性的值必须大于 SessionShortExpirationInterval 属性的值。
InMemory	可选	开关参数	创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的命令的输出分配给某变量，则可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。
Force	可选	开关参数	禁止显示运行此命令时可能出现的任何非严重错误消息。
WhatIf	可选	开关参数	描述如果执行命令会发生什么情况（无需实际执行命令）。
Confirm	可选	开关参数	在执行命令之前提示您进行确认。

输入类型

无。New-CsMcxConfiguration 不接受通过管道传递的输入。

返回类型

创建 Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration 对象的新实例。

示例

-------------------------- 示例 1 --------------------------

New-CsMcxConfiguration -Identity "site:Redmond" -ExposedWebURL Internal -SessionShortExpirationInterval 7200

在示例 1 中，为 Redmond 站点创建（并自动分配）Mobility Service 配置设置的新集合。在本例中，对默认 Mobility Service 配置设置进行了两处更改：ExposedWebURL 属性设置为 Internal，SessionShortExpirationInterval 属性设置为 7200 秒。

-------------------------- 示例 2 --------------------------

Get-CsService -WebServer | ForEach-Object {New-CsMcxConfiguration -Identity $_.Identity -ExposedWebURL Internal -SessionShortExpirationInterval 7200}

在示例 2 中，为组织中当前使用的每个 Web 服务器创建一组相同的 Mobility Service 配置设置。为执行此任务，使用了 Get-CsService cmdlet 和 WebServer 参数，以返回所有现有 Web 服务器的集合；然后将此集合通过管道传递到 For-Each 对象 cmdlet。之后，ForEach-Object 选取集合中的每个服务器，并运行 New-CsMcxConfiguration cmdlet，以便在该服务器上创建新 Mobility Service 配置设置。

-------------------------- 示例 3 --------------------------

$x = New-CsMcxConfiguration -Identity "site:Redmond" -InMemory
$x.ExposedWebURL = "Internal"
$x.SessionShortExpirationInterval = 7200
Set-CsMcxConfiguration -Instance $x

上面的示例演示 InMemory 参数如何允许您在内存中创建新的 Mobility Service 配置设置集合，修改该集合的属性值，然后将该集合保存到 Lync Server。为此，集合中的第一个命令创建 Identity 为 site:Redmond 的 Mobility Service 配置设置的新集合。但是，由于 InMemory 参数的存在，将仅在内存中创建这些设置，然后存储在名为 $x 的变量中，而不是自动创建这些设置并将其分配给 Redmond 站点。

示例中的命令 2 和 3 显示如何修改此虚拟 Mobility Service 配置集合的属性值。修改完属性值后，可以使用 Set-CsMcxConfiguration cmdlet 和 Instance 参数将虚拟设置转换为分配给 Redmond 站点的 Mobility Service 配置设置的实际集合。注意，如果不调用 Set-CsMcxConfiguration，则不会为 Redmond 站点分配设置，并且您的虚拟集合将在您退出 Windows PowerShell 会话或删除变量 $x 后立即消失。