Remove-CsMcxConfiguration

 

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

删除指定的 Microsoft Lync Server 2010 Mobility Service 配置设置集合。Mobility Service 使移动电话(如 iPhone 和 Windows Phone)用户能够执行如下操作:交换即时消息和状态信息;在内部而不是使用其无线提供商存储和检索语音邮件;以及利用 Microsoft Lync Server 2010 功能(如通过工号拨号和电话拨出式会议)。

语法

Remove-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 配置设置集合;但是,管理员可以在 site 作用域或 service 作用域创建自定义配置设置。以后可以使用 Remove-CsMcxConfiguration cmdlet 删除这些自定义设置。如果删除服务设置,之前由这些设置管理的 Mobility Service 服务器将由网站设置(如果存在)或全局设置管理。如果删除网站设置,服务器将由全局设置管理。

请注意,还可以针对全局设置运行 Remove-CsMcxConfiguration cmdlet。但如果这样做,将不会删除全局设置。不过全局集合中的属性将重置为其默认值。

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

参数

参数 必需 类型 描述

Identity

必需

Xds 标识

要删除的 Mobility Service 配置设置的唯一标识符。要“删除”全局设置,请使用以下语法:

-Identity global

请注意,您无法实际删除全局设置,只能将属性重置为其默认值。

要删除 site 作用域中的设置,请使用以下类似语法:

-Identity site:Redmond

要删除在 service 作用域内配置的设置,请使用类似于这种形式的语法:

-Identity service:WebServer:atl-cs-001.litwareinc.com

在指定 Identity 时不能使用通配符。

Force

可选

开关参数

禁止显示运行此命令时可能出现的任何非严重错误消息。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

.SwitchParameter

在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration。Remove-CsMcxConfiguration 接受通过管道传递的 McxConfiguration 对象的输入。

返回类型

无。此 cmdlet 会删除 Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration 对象的实例。

示例

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

Remove-CsMcxConfiguration -Identity "site:Redmond"

示例 1 中显示的命令会删除分配给 Redmond 站点的 Mobility Service 配置设置集合。

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

Get-CsMcxConfiguration -Filter "service:*" | Remove-CsMcxConfiguration

在示例 2 中,将删除分配给 service 作用域的所有 Mobility Service 配置设置。为此,将 Get-CsMcxConfiguration 与 Filter 参数一起使用;筛选器值“service:*”确保仅返回其 Identity 以字符串值“service:”开头的设置。然后通过管道将该集合传递到 Remove-CsMcxConfiguration cmdlet,并由其删除。

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

Get-CsMcxConfiguration | Where-Object {$_.ExposedWebURL -eq "Internal"} | Remove-CsMcxConfiguration

上述命令会删除 ExposedWebURL 属性已设置为 Internal 的所有 Mobility Service 配置设置。为执行此任务,此命令首先调用不带任何参数的 Get-CsMcxConfiguration;这将返回组织中当前使用的所有 Mobility Service 配置设置的集合。然后将该集合通过管道传递到 Where-Object cmdlet,后者仅挑选出 ExposedWebURL 等于 (-eq) Internal 的设置。之后将筛选出的集合通过管道传递给 Remove-CsMcxConfiguration,后者将删除该集合中的每一项。

-------------------------- 示例 4 --------------------------

Get-CsMcxConfiguration | Where-Object {$_.PushNotificationProxyUri -eq $Null} | Remove-CsMcxConfiguration

在示例 4 中,将从 Lync Server 删除不具有分配的推送通知代理 URI 的所有 Mobility Service 配置设置。为此,此命令首先使用不带任何参数的 Get-CsMcxConfiguration 返回当前使用的所有 Mobility Service 配置设置的集合。然后将该集合通过管道传递到 Where-Object cmdlet,后者仅挑选出 PushNotificationProxyUri 属性等于 (-eq) 空值的任何设置。满足该条件的任何设置随后通过管道传递到 Remove-CsMcxConfiguration cmdlet,并由其删除。