New-CsExUmContact
上一次修改主题： 2012-03-25
为托管 Exchange 统一消息 (UM) 创建新的自动助理或订阅者访问联系人对象。
语法
New-CsExUmContact -DisplayNumber <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> -SipAddress <String> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 与 Exchange UM 结合使用以提供一些与语音相关的功能，包括自动助理和订阅者访问。以托管服务（而不是内部部署）的形式提供 Exchange UM 时，必须使用此 cmdlet 创建联系人对象以便应用自动助理和订阅者访问功能。这些对象通过调用 New-CsExUmContact cmdlet 来创建。
只有应用托管语音邮件策略以配置联系人的路由之后，使用此 cmdlet 创建的联系人对象才会在系统内可用。您可以通过调用 Get-CsHostedVoicemailPolicy cmdlet 来检索托管语音邮件策略。通过检索到的策略，您可以确定是否存在相应的全局或站点策略，或者是否存在需要授予此联系人的每用户策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsExUmContact cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsExUmContact"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
SipAddress |
必需 |
字符串 |
联系人的 SIP 地址。此地址必须是 Active Directory 域服务 (AD DS)中的用户或联系人没有使用过的新地址。此值必须以字符串 sip: 开头，后跟 SIP 地址。 |
RegistrarPool |
必需 |
Fqdn |
运行 Registrar 服务的池的完全限定域名 (FQDN)。 请注意，不能将 Lync Server 2010 中的 Exchange UM 联系人移动到作为 Microsoft Office Communications Server 2007 部署或 Microsoft Office Communications Server 2007 R2 部署一部分的池中。 完整数据类型：Microsoft.Rtc.Management.Deploy.Fqdn |
DisplayNumber |
必需 |
字符串 |
联系人的电话号码。每个联系人的显示号码必须是唯一的（例如，两个 Exchange UM 联系人不能使用相同的显示号码）。 此值可以以加号 (+) 开头，并且可以包含任意位数字。第一位数字不能为零。 |
OU |
必需 |
OUIdParameter |
此联系人在 Active Directory 中所在的组织单位 (OU)。 完整数据类型：Microsoft.Rtc.Management.AD.OUIdParameter |
AutoAttendant |
可选 |
布尔值 |
指定此联系人对象是否为自动助理。（自动助理提供了一组语音提示，允许呼叫者导航电话系统并最终到达预期的一方。） 默认值：False |
Description |
可选 |
字符串 |
此联系人的描述。管理员可使用此描述来识别联系人的类型（自动助理或订阅者访问）、位置、提供者或其他任何用于识别每个 Exchange UM 联系人的目的的信息。 |
PassThru |
可选 |
开关参数 |
返回此命令的结果。运行此 cmdlet 将显示新创建的对象；包含此参数只会重复该输出，使得对此参数的使用变得多余。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsExUmContact -SipAddress sip:exumsa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065554567
此示例调用 New-CsExUmContact cmdlet 以创建新的 Exchange UM Active Directory 联系人对象。要创建新的联系人，必须提供自动助理或订阅者访问的 SIP 地址（在此示例中为 sip:exumsa1@fabrikam.com）。此外，还必须提供运行 Lync Server 2010 Registrar 服务的池的名称 (RedmondPool.litwareinc.com)、用于存储此信息的 OU (OU=ExUmContacts,DC=litwareinc,DC=com) 以及自动助理或订阅者访问的电话号码 (2065554567)。由于没有明确设置 AutoAttendant 参数，因此将应用默认值 False，从而将此联系人对象假定为订阅者访问联系人。
-------------------------- 示例 2 --------------------------
New-CsExUmContact -SipAddress sip:exumaa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065559876 -AutoAttendant $True
与示例 1 类似，此示例也调用 New-CsExUmContact cmdlet 以创建一个新的 Exchange UM 联系人。我们再创建一个新的自动助理或订阅者访问联系人，这次使用 SIP 地址 sip:exumaa1@fabrikam.com。然后，我们提供运行 Lync Server 2010 Registrar 服务的池的名称 (RedmondPool.litwareinc.com)、用于存储此信息的 OU (OU=ExUmContacts,DC=litwareinc,DC=com) 以及自动助理或订阅者访问的电话号码 (2065554567)。此示例中的不同之处在于，我们将可选参数 AutoAttendant 设置为 True ($True)，以指出此对象事实上为自动助理联系人。