Move-CsCommonAreaPhone

 

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

将一个或多个公用区域电话移至新的注册器池。

语法

Move-CsCommonAreaPhone -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

详细说明

公用区域电话是不与个别用户关联的 IP 电话,通常不是位于某人的办公室,而是位于建筑物大厅、餐厅、员工休息室、会议室和其他可能有大量人员聚集的位置。这为管理员的管理工作带来了挑战,因为 Lync Server 2010 中的电话使用通常是使用分配给个别用户的语音策略和拨号计划维护。不会为公用区域电话分配个别用户。

解决此挑战的方法是为所有公用区域电话创建 Active Directory 联系人对象。(可以使用 New-CsCommonAreaPhone cmdlet 来创建这些联系人对象。)与用户帐户相同,可以为这些联系人对象分配策略和语音计划。这样,即使公用区域电话未与个别用户关联,也可以控制这些电话。例如,如果您不希望用户能够转接或驻留来自公用区域电话的呼叫,可以创建禁止呼叫转接和呼叫驻留的语音策略,然后将该策略分配给公用区域电话。(更准确地说,分配给代表公用区域电话的联系人对象。)

通过 Move-CsCommonAreaPhone cmdlet,可以将现有的公用区域电话移至新的注册器池。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Move-CsCommonAreaPhone cmdlet:RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission cmdlet 分配针对特定站点或特定 Active Directory 组织单位 (OU) 运行此 cmdlet 的权限。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsCommonAreaPhone"}

参数

参数 必需 类型 描述

Identity

必需

UserID

公用区域电话的唯一标识符。使用相关联系人对象的 Active Directory 可分辨名称标识公用区域电话。默认情况下,公用区域电话使用全局唯一标识符 (GUID) 作为其公用名,这意味着电话通常会具有类似如下的标识:CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。

Target

必需

FQDN

应移动公用区域电话的注册器池的完全限定域名 (FQDN);例如:atl-cs-001.litwareinc.com。除了注册器池以外,目标还可以是宿主提供商的 FQDN。

DomainController

可选

FQDN

使您可以连接到指定的域控制器,以便移动公用区域电话。要连接到特定的域控制器,请包含 DomainController 参数,后跟计算机名称(例如 atl-cs-001)或其 FQDN(例如 atl-cs-001.litwareinc.com)。

ProxyPool

可选

完全限定域名

此参数仅用于 Microsoft Lync Online 2010。不应将其与 Lync Server 的内部部署实现结合使用。

Force

可选

开关参数

如果存在,则将移动公用区域电话但会删除所有相关数据(例如分配给该设备的策略)。如果不存在,将同时移动电话和相关数据。

PassThru

可选

开关参数

使您可以通过管道传递用户对象(代表要移动的用户帐户)。默认情况下,Move-CsCommonAreaPhone cmdlet 不会通过管道传递对象。

WhatIf

可选

开关参数

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

Confirm

可选

开关参数

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

输入类型

字符串。Move-CsCommonAreaPhone 接受通过管道传递的字符串值,代表公用区域电话的标识。

返回类型

默认情况下,Move-CsCommonAreaPhone 不会返回任何对象或值。但是,如果包含 PassThru 参数,则此 cmdlet 将返回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 对象的实例。

示例

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

Move-CsCommonAreaPhone -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com

示例 1 中显示的命令将 Identity 为 CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com 的公用区域电话移至注册器池 atl-cs-001.litwareinc.com。

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

Get-CsCommonAreaPhone | Where-Object {$_.DisplayName -eq "Building 31 Cafeteria"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com

在示例 2 中,将 Active Directory 显示名称为“Building 31 Cafeteria”的公用区域电话移至注册器池 atl-cs-001.litwareinc.com。为执行此操作,首先调用不带任何参数的 Get-CsCommonAreaPhone,以返回组织中当前使用的所有公用区域电话的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会仅挑选 DisplayName 属性等于“Building 31 Cafeteria”的电话。接下来,将筛选出的集合通过管道传递到 Move-CsCommonAreaPhone,后者会将集合中的每个电话都移至 atl-cs-001.litwareinc.com。

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

Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com

上述示例将注册器池 dublin-cs-001.litwareinc.com 当前托管的所有公用区域电话移至注册器池 atl-cs-001.litwareinc.com。为完成此任务,该命令首先调用不带任何参数的 Get-CsCommonAreaPhone;这将返回配置为在组织中使用的所有公用区域电话的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会仅挑选 RegistrarPool 等于 dublin-cs-001.litwareinc.com 的所有公用区域电话。接下来,将该集合通过管道传递到 Move-CsCommonAreaPhone,后者会将集合中的每个电话都移至新的注册器池 atl-cs-001.litwareinc.com。

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

Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com -PassThru | Grant-CsVoicePolicy -PolicyName AtlantaVoicePolicy

示例 4 是示例 3 中显示的命令的变体。但在此示例中,公用区域电话不仅移至新的注册器池,还分配了新的每用户语音策略。为执行此操作,调用 Move-CsCommonAreaPhone 时加入了 PassThru 参数,以便通过管道传递公用区域电话对象。(默认情况下,Move-CsCommonAreaPhone 不会通过管道传递对象。)移动电话之后,电话对象将通过管道传递到 Grant-CsVoicePolicy cmdlet,后者会将语音策略 AtlantaVoicePolicy 分配给新移动的每个电话。