Get-CsComputer

 

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

返回有关在 Microsoft Lync Server 2010 基础结构中执行服务角色的计算机的信息。

语法

Get-CsComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]

Get-CsComputer [-Filter <String>] [-Pool <String>]

详细说明

Get-CsComputer 提供了一种方法,用于快速标识正在运行 Lync Server 2010 服务或服务器角色的计算机。如果不带任何参数进行调用,Get-CsComputer 将返回正在运行 Lync Server 2010 服务或服务器角色的所有计算机的集合;此集合包括每台计算机的标识、池名称和完全限定域名 (FQDN)。此外,您也可以使用可选参数(如 Identity、Filter 或 Pool)将返回的数据限制为单台计算机或一组计算机。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsComputer cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。

参数

参数 必需 类型 描述

Identity

可选

字符串

要返回的计算机的 FQDN。例如:-Identity "atl-cs-001.litwareinc.com"。

如果未指定此参数,将返回所有运行 Lync Server 2010 的计算机。

Filter

可选

字符串

使您可以在指定要返回的计算机的 Identity 时使用通配符。例如,以下命令将返回有关 Identity 以字符串值“atl-”开头的所有计算机的信息:-Filter "atl-*"。

Pool

可选

字符串

Lync Server 2010 池的 FQDN。使用此参数时,将返回有关指定池中所有计算机的信息。

输入类型

无。Get-CsComputer 不接受通过管道传递的输入。

返回类型

Get-CsComputer 返回 Microsoft.Rtc.Management.Deploy.Internal.Machine 对象的实例。

示例

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

Get-CsComputer

在示例 1 中,Get-CsComputer cmdlet 用于返回有关在 Lync Server 2010 基础结构中执行服务角色的所有计算机的信息。

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

Get-CsComputer -Filter "*.litwareinc.com"

示例 2 中显示的命令使用 Filter 参数,以便仅返回属于 litwareinc.com 域的服务角色计算机。通配符字符串 *.litwareinc.com 将返回的信息限制为 FQDN 以字符串值“.litwareinc.com”结尾的计算机。

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

Get-CsComputer -Identity "atl-cs-001.litwareinc.com"

在上述示例中,使用 Identity 参数将返回的数据限制为 FQDN 等于 atl-cs-001.litwareinc.com 的一台计算机。

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

Get-CsComputer -Pool "atl-cs-001.litwareinc.com"

在示例 4 中,Pool 参数用于返回在池 atl-cs-001.litwareinc.com 中找到的所有计算机的信息。