New-CsAnalogDevice
上一次修改主题： 2012-03-23
创建可通过 Microsoft Lync Server 2010 管理的新模拟设备。模拟设备是指连接到公用电话交换网 (PSTN) 的电话或其他设备。
语法
New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
详细说明
模拟设备包括连接到公用电话交换网 (PSTN) 的电话、传真机、调制解调器和失聪人士专用电传/电信设备 (TTY/TTD) 设备。与利用企业语音（Microsoft 提供的 IP 电话 (VoIP) 解决方案）的设备不同，模拟设备不使用数字数据包传输信息，而是使用连续的信号传输信息。此信号通常称为模拟信号；因此产生了术语“模拟设备”。
为了使管理员能够管理模拟设备，您可以使用 Lync Server 2010 将模拟设备与 Active Directory 联系人对象关联。将设备与联系人对象关联后，就可以通过向联系人分配策略和拨号计划来管理模拟设备。
使用 New-CsAnalogDevice cmdlet 创建新的模拟设备。此 cmdlet 可以创建与模拟设备结合使用的新联系人对象，或将现有联系人对象与新设备相关联。有关详细信息，请参阅本主题中的 OU 和 DN 参数的描述。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsAnalogDevice cmdlet：RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission cmdlet 分配针对特定站点或特定 Active Directory 组织单位 (OU) 运行此 cmdlet 的权限。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAnalogDevice"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
LineUri |
必需 |
字符串 |
模拟设备的电话号码。应该使用 E.164 格式指定线路统一资源标识符 (URI)，并加上“TEL:”前缀。例如：TEL:+14255551297。应将所有分机号添加到线路 URI 的末尾，例如："TEL:+14255551297;ext=51297"。 |
SipAddress |
可选 |
SIP 地址 |
允许模拟设备与 SIP 设备（例如 Microsoft Lync 2010）进行通信的唯一标识符（类似于电子邮件地址）。SIP 地址必须以“sip:”作为前缀。例如：sip:bldg14lobby@litwareinc.com。 |
RegistrarPool |
必需 |
字符串 |
用于托管联系人对象的注册器池的完全限定域名 (FQDN)。例如：-RegistrarPool "atl-cs-001.litwareinc.com"。 |
DisplayName |
可选 |
字符串 |
配置模拟设备的 Active Directory 显示名称。 |
DisplayNumber |
可选 |
字符串 |
显示在 Lync 2010 中的电话号码。您可以采用所喜欢的任意方式设置 DisplayNumber 属性的格式；例如 1-800-555-1234、1-(800)-555-1234、1.800.555.1234 等。 |
AnalogFax |
必需 |
布尔值 |
如果模拟设备是传真机，则设置为 True ($True)。如果设备不是传真机，则设置为 False ($False)。 |
Gateway |
必需 |
字符串 |
模拟设备要使用的 PSTN 网关的 IP 地址。 |
OU |
必需 |
Active Directory 可分辨名称 |
联系人对象所在的 Active Directory 组织单位 (OU) 的可分辨名称。例如：-OU "ou=Redmond,dc=litwareinc,dc=com"。 如果包含 OU 参数，将在指定的 OU 中创建新联系人，并将自动为该联系人分配 GUID（全局唯一标识符）以作为其公用名。因此，联系人对象的名称将类似如下：{ce84964a-c4da-4622-ad34-c54ff3ed361f}。 |
DN |
可选 |
Active Directory 可分辨名称 |
使您可以将现有的 Active Directory 联系人对象与模拟设备相关联。如果要将联系人对象与模拟设备相关联，请使用 DN 参数后跟该联系人的可分辨名称。例如：-DN "cn=Building 14 Lobby,dc=litwareinc,dc=com"。请注意，如果指定的联系人不存在，该命令将失败。 不能在同一个命令中同时使用 OU 和 DN 参数。 |
PassThru |
可选 |
开关参数 |
返回代表公用区域电话的对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsAnalogDevice 不接受通过管道传递的输入。
返回类型
New-CsAnalogDevice 创建 Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com"
示例 1 中显示的命令创建电话号码 (LineUri) 为 1-425-555-6001 的新模拟设备。（请注意，必须使用 E.164 格式指定该电话号码。）除了 LineUri 参数之外，该命令中使用的其他参数包括：DisplayName（设置设备的 Active Directory 显示名称）、RegistrarPool（指定注册器池）、AnalogFax（设置为 $False，指示该设备是电话而不是传真机）、Gateway（设置为网关的 IP 地址）以及 OU（要在其中创建设备联系人对象的 Active Directory OU 的可分辨名称）。