Get-CsAnalogDevice
上一次修改主题： 2012-03-23
返回有关可以使用 Microsoft Lync Server 2010 管理的模拟设备的信息。模拟设备是连接到公用电话交换网的电话或其他设备。
语法
Get-CsAnalogDevice [-Identity] <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
详细说明
模拟设备包括连接到公用电话交换网 (PSTN) 的电话、传真机、调制解调器和失聪人士专用电传/电信设备 (TTY/TTD) 设备。与利用企业语音（Microsoft 提供的 IP 电话 (VoIP) 解决方案）的设备不同，模拟设备不使用数字数据包传输信息，而是使用连续的信号传输信息。此信号通常称为模拟信号；因此产生了术语“模拟设备”。
除了模拟电话和利用企业语音的电话外，还有另一类电话：数字非 IP 电话。这些电话专用于与它们一起采购的专用交换机 (PBX) 系统，且不能使用 Lync Server 2010 cmdlet 进行管理。
为了使管理员能够管理组织的模拟设备，您可以使用 Lync Server 2010 将模拟设备与 Active Directory 联系人对象关联。将设备与联系人对象关联后，就可以通过执行向联系人分配策略和拨号计划等操作来管理模拟设备。
Get-CsAnalogDevice cmdlet 提供了一种检索有关配置为在组织中使用的模拟设备的信息的方法。如果调用不带任何参数的 Get-CsAnalogDevice，该 cmdlet 将返回有关所有模拟设备的信息。可选参数提供了各种筛选信息的方法，例如，可以返回在指定 OU 中具有联系人对象的所有设备，或返回位于指定建筑物中的所有模拟设备。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsAnalogDevice cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。可以使用 Grant-CsOUPermission cmdlet 分配针对特定站点或特定 Active Directory OU 运行此 cmdlet 的权限。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAnalogDevice"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户 ID 参数 |
模拟设备的唯一标识符。模拟设备是使用关联的联系人对象的 Active Directory 可分辨名称进行标识的。默认情况下，模拟设备使用 GUID（全局唯一标识符）作为其公用名；这意味着设备通常会带有一个以下类似标识：CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。 |
Credential |
可选 |
PS 凭据对象 |
使您可以通过备用凭据运行 Get-CsAnalogDevice cmdlet。如果您登录 Windows 时所使用的帐户没有使用联系人对象所需的必要权限，则可能需要使用该对象。 要使用 Credential 参数，请先使用 Get-Credential cmdlet 创建 PSCredential 对象。有关详细信息，请参阅 Get-Credential cmdlet 帮助主题。 |
DomainController |
可选 |
字符串 |
使您可以连接到指定的域控制器，以便检索联系人信息。要连接到特定的域控制器，请包含 DomainController 参数，后跟计算机的完全限定域名 (FQDN)（例如 atl-cs-001.litwareinc.com）。 |
Filter |
可选 |
字符串 |
用于通过筛选特定于 Lync Server 2010 的属性来限制返回的数据。例如，您可以将返回数据限制为已分配特定语音策略的模拟设备联系人对象，或尚未分配特定语音策略的联系人。 Filter 参数与 Where-Object cmdlet 使用相同的 Windows PowerShell 筛选语法。例如，仅返回传真机的筛选器语法如下，其中 AnalogFax 代表 Active Directory 属性，-eq 代表比较运算符（等于），$True（内置的 Windows PowerShell 变量）代表筛选器值： -Filter {AnalogFax -eq $True} |
LdapFilter |
可选 |
字符串 |
使您可以通过筛选 Active Directory 常规属性（即不是特定于 Lync Server 2010 的属性）来限制返回的数据。例如，您可以将返回的数据限制为已分配给特定部门或位于特定建筑物中的联系人对象。 LdapFilter 参数在创建筛选器时使用 LDAP 查询语言。例如，仅返回代表雷蒙德市的模拟设备的联系人对象的筛选器语法如下： -LdapFilter "l=Redmond" 在上述筛选器中，“l”代表 Active Directory 属性 (locality)；“=”代表比较运算符（等于）；“Redmond”代表筛选器值。 |
OU |
可选 |
Active Directory 可分辨名称 |
使您可以返回特定 Active Directory 组织单位 (OU) 中的联系人对象。这将从指定 OU 及其所有子 OU 返回数据。例如，如果 Finance OU 有两个子 OU：AccountsPayable 和 AccountsReceivable，则将从这些 OU 返回模拟设备信息。 指定 OU 时，请使用此容器的可分辨名称，例如：-OU "OU=Finance,dc=litwareinc,dc=com"。 |
ResultSize |
可选 |
整数 |
使您可以限制命令返回的记录数。例如，要返回七个模拟设备（不管林中有多少模拟设备），请包含 ResultSize 参数，并将参数值设置为 7。请注意，无法保证返回哪七个电话。如果将 ResultSize 设置为 7，但是林中仅有三个模拟设备，则此命令将返回这三个设备，操作完成，并且不生成错误。 结果大小可以设置为 0 到 2147483647（包含边界值）之间的任意整数。如果设置为 0，命令将运行，但是不会返回任何数据。 |
输入类型
字符串。Get-CsAnalogDevice 接受通过管道传递的代表模拟设备 Identity 的字符串值。
返回类型
Get-CsAnalogDevice 返回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAnalogDevice
示例 1 中显示的命令返回当前配置为在组织中使用的所有模拟设备的集合。这可以通过调用不带任何参数的 Get-CsAnalogDevice 完成。
-------------------------- 示例 2 --------------------------
Get-CsAnalogDevice | Select-Object DisplayName, LineUri
在示例 2 中，仅返回组织中所有模拟设备的两个属性值：DisplayName 和 LineUri。为完成此任务，此命令首先调用不带任何参数的 Get-CsAnalogDevice，这将返回组织中所有模拟设备的所有属性值。然后，将该集合通过管道传递到 Select-Object cmdlet，后者将仅选择并显示 DisplayName 和 LineUri 属性的值。
-------------------------- 示例 3 --------------------------
Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"}
示例 3 返回有关 Active Directory 显示名称为“Building 14 Receptionist”的模拟设备的信息。为执行此操作，该命令调用 Get-CsAnalogDevice 和 Filter 参数，筛选器值 {DisplayName -eq "Building 14 Receptionist"} 将返回的项限制为 DisplayName 属性等于“Building 14 Receptionist”的模拟设备。
-------------------------- 示例 4 --------------------------
Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"}
上述命令返回所有为网关 192.168.0.240 配置的模拟设备。这是通过调用 Get-CsAnalogDevice 并包含 Filter 参数来完成的，筛选器值“192.168.0.240”可确保返回对象仅为 Gateway 属性等于 192.168.0.240 的模拟设备。
-------------------------- 示例 5 --------------------------
Get-CsAnalogDevice -Filter {AnalogFax -eq $True}
示例 5 中显示的命令返回有关组织中所有模拟传真机的信息。为执行此任务，该命令调用带有 Filter 参数的 Get-CsAnalogDevice。筛选器值 {AnalogFax -eq $True} 将返回对象限制为传真机：AnalogFax 属性等于 True 的模拟设备。
-------------------------- 示例 6 --------------------------
Get-CsAnalogDevice -Filter {LineUri -eq "tel:+14255556001"}
在示例 6 中，只返回一个模拟设备：LineUri（电话号码）等于 +14255556001 的设备。
-------------------------- 示例 7 --------------------------
Get-CsAnalogDevice -Filter {LineUri -like "tel:+1425555*"}
示例 7 返回所有区号是 425 且电话前缀是 555 的模拟设备。为完成此任务，使用带有 Filter 参数的 Get-CsAnalogDevice；筛选器值 {LineUri -like "tel:+1425555*"} 将返回数据限制为 LineUri 属性以字符“tel:+1425555”开头的设备。该值等效于以这些字符开头的电话号码：1425555（例如，1-425-555-1298）。
-------------------------- 示例 8 --------------------------
Get-CsAnalogDevice -OU "ou=Telecommunications,dc=litwareinc,dc=com"
上述命令返回在 Active Directory 域服务 (AD DS) 的 Telecommunications OU 中具有联系人对象的所有模拟设备的集合。为执行此操作，调用带有 OU 参数的 Get-CsAnalogDevice；参数值将返回对象限制为在可分辨名称为 ou=Telecommunications,dc=litwareinc,dc=com 的 OU 中具有联系人对象的模拟设备。
-------------------------- 示例 9 --------------------------
Get-CsAnalogDevice | Grant-CsVoicePolicy -PolicyName "AnalogVoicePolicy"
示例 9 中显示的命令说明了如何返回模拟设备的集合，然后为集合中的每个设备分配语音策略。为执行此操作，首先调用不带任何参数的 Get-CsAnalogDevice；这样可返回配置为在组织中使用的所有模拟设备的集合。然后，将该集合通过管道传递到 Grant-CsVoicePolicy cmdlet，后者为集合中的每个设备分配语音策略 AnalogVoicePolicy。