Managed Terminal Services::GetServers

  • Article

The method returns a list of the terminal servers within a domain. This does not include servers found in child domains of the specified domain.

Arguments

Input Arguments Required Description

<domain>

Yes

The name of the domain to search for terminal servers. If the domain name is empty, a list of terminal servers in the domain of the MPF engine will be returned.

<preferredDomainController>

Yes

The name of the preferred domain controller to be used to check the permissions of the caller.

A list of all terminal servers in the domain, with the following structure:

Output Arguments Description

<servers/server>

The name of a terminal server

Remarks

Security

Permitted to DomainAdmins only

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Managed Terminal Services" 
             procedure="GetServers"> 
      <executeData> 
        <domain>TheDomain</domain> 
        <preferredDomainController>dc1</preferredDomainController> 
      </executeData> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response> 
  <executeData> 
    <domain>TheDomain</domain> 
    <preferredDomainController>dc1</preferredDomainController> 
    <servers> 
      <server>TerminalServerA</server> 
      <server>TerminalServerB</server> 
      <server>TerminalServerC</server> 
    </servers> 
  </executeData> 
</response>

Applies To

Terminal Services Namespace

See also

Tasks

Managed Terminal Services::GetSessions
Managed Terminal Services::ControlServer