Share via

Using the TcmSetup Command-Line Tool

  • Article

Applies To: Windows Server 2008, Windows Server 2012

The TcmSetup command-line tool configures or disables the telephony client. In order for telephony functions to work correctly, you must run tcmsetup to specify the remote servers that will be used by telephony clients.

Configuring a client to use a remote server

Syntax

tcmsetup [/q] [/x] /cServer1 [Server2...]

Parameters
  • /q
    Prevents the display of message boxes.
  • /x
    Specifies that connection-oriented callbacks will be used for heavy traffic networks where packet loss is high. When this parameter is omitted, connectionless callbacks will be used.
  • /c
    Required. Specifies client setup.
  • Server1
    Required. Specifies the name of the remote server that has the telephony service providers that the client will use. The client will use the lines and phones of this service provider. The client must be in the same domain as the server or in a domain that has a two-way trust relationship with the domain that contains the server.
  • Server2...
    Specifies any additional server or servers that will be available to this client. If you specify a list of servers is, use a space to separate the server names.
  • /?
    Displays help at the command prompt.

Disabling a telephony client

Syntax

tcmsetup [/q] /c /d

  • /q
    Prevents the display of message boxes.
  • /c
    Required. Specifies client setup.
  • /d
    Required. Clears the list of remote servers. Disables the TAPI client by preventing it from using the TAPI service providers that are on the remote servers.
  • /?
    Displays help at the command prompt.

Additional considerations

  • Before a client user can use a phone or line on a telephony server, the telephony server administrator must assign the user to the phone or line.

  • The list of telephony servers that is created by this command replaces any existing list of telephony servers available to the client. You cannot use this command to add to the existing list.

Formatting legend

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

See Also

Concepts

Manage Telephony Servers
Manage Telephony Service Providers on a Server
Manage Telephony Clients and Users
Using the TSecImp Command-Line Tool