See Also
Topic Last Modified: 2013-03-06
Returns information about the computers that perform service roles within your Lync Server infrastructure. This cmdlet was introduced in Lync Server 2010.
Syntax
Get-CsComputer [-Identity
<XdsGlobalRelativeIdentity>] <COMMON PARAMETERS>
|
Get-CsComputer [-Filter <String>] <COMMON
PARAMETERS>
|
COMMON PARAMETERS: [-Local <SwitchParameter>]
[-Pool <String>]
|
Examples
EXAMPLE 1
In Example 1 the Get-CsComputer cmdlet is used to return information about all the computers that perform service roles within your Lync Server infrastructure.
 Copy Code |
|
|---|---|
Get-CsComputer |
|
EXAMPLE 2
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 an FQDN that ends with the string value ".litwareinc.com".
| Copy Code |
|
|---|---|
Get-CsComputer -Filter "*.litwareinc.com" |
|
EXAMPLE 3
In Example 3, the Identity parameter is used to limit the returned data to the one computer that has the FQDN atl-cs-001.litwareinc.com.
| Copy Code |
|
|---|---|
Get-CsComputer -Identity "atl-cs-001.litwareinc.com" |
|
EXAMPLE 4
In Example 4, the Pool parameter is used to return information about all the computers found in the pool atl-cs-001.litwareinc.com.
| Copy Code |
|
|---|---|
Get-CsComputer -Pool "atl-cs-001.litwareinc.com" |
|
Detailed Description
The Get-CsComputer cmdlet provides a way to quickly identify computers that are running Lync Server services or server roles. Called without any parameters, the Get-CsComputer cmdlet returns a collection of all the computers that are running Lync Server services or server roles; this collection includes the Identity, pool name, and fully qualified domain name (FQDN) 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.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsComputer cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Filter |
Optional |
System.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-*". |
|
Identity |
Optional |
Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity |
FQDN of the computer to be returned. For example: -Identity "atl-cs-001.litwareinc.com". If this parameter is not specified, all of the computers running Lync Server will be returned. |
|
Local |
Optional |
System.Management.Automation.SwitchParameter |
When present, returns information only for the local computer. |
|
Pool |
Optional |
System.String |
FQDN of a Lync Server pool. When you use this parameter, information about all the computers in the specified pool will be returned. |
Input Types
None. The Get-CsComputer cmdlet does not accept pipelined input.
Return Types
The Get-CsComputer cmdlet returns instances of the Microsoft.Rtc.Management.Deploy.Internal.Machine object.
