[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Returns information about the computers that perform service roles within your Microsoft Communications Server 2010 infrastructure.

Syntax


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


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

Parameters

Parameter	Required	Type	Description
Identity	Optional	String	Fully qualified domain name of the computer to be returned. For example: -Identity "atl-cs-001.litwareinc.com". If this parameter is not specified, all the Communication Server computers will be returned.
Filter	Optional	String	Enables you to use wildcard characters when specifying the Identity of the computer (or computers) to be returned. For example, this command returns information about all the computers that have an Identity that begins with the string value "atl-": -Filter "atl-*".
Pool	Optional	String	Fully qualified domain name of a Microsoft Communications Server pool. When you use this parameter, information about all the computers in the specified pool will be returned.

Parameter

Required

Type

Description

Identity

Optional

String

Fully qualified domain name of the computer to be returned. For example: -Identity "atl-cs-001.litwareinc.com".

If this parameter is not specified, all the Communication Server computers will be returned.

Filter

Optional

String

Enables you to use wildcard characters when specifying the Identity of the computer (or computers) to be returned. For example, this command returns information about all the computers that have an Identity that begins with the string value "atl-": -Filter "atl-*".

Pool

Optional

String

Fully qualified domain name of a Microsoft Communications Server pool. When you use this parameter, information about all the computers in the specified pool will be returned.

Detailed Description

Get-CsComputer provides a way to quickly identify computers that are running Microsoft Communications Server services or server roles. Called without any parameters, Get-CsComputer returns a collection of all the computers that are running Microsoft Communications Server services or server roles. This collection includes the Identity, pool name, and fully qualified domain name for each computer. Alternatively, you can use optional parameters such as –Identity, -Filter, or –Pool to limit the returned data to a single computer or set of computers.

Return Types

Get-CsComputer returns instances of the Microsoft.Rtc.Management.Deploy.Internal.Machine object.

Examples

-------------------------- Example 1 --------------------------

	Copy Code
Get-CsComputer

In Example 1 the Get-CsComputer cmdlet is used to return information about all the computers that perform service roles within your Communications Server 2010 infrastructure.

-------------------------- Example 2 --------------------------

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

The command shown in Example 2 uses the -Filter parameter to return only those service role computers that are part of the litwareinc.com domain. The wildcard string *.litwareinc.com restricts the returned information to computers that have a fully qualified domain name (FQDN) that ends with .litwareinc.com.

-------------------------- Example 3 --------------------------

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

In the preceding example, the -Identity parameter is used to limit the returned data to the one computer that has the fully qualified domain name atl-cs-001.litwareinc.com.