Deactivating Servers

Microsoft Office Communications Server 2007 and Microsoft Office Communications Server 2007 R2 will reach end of support on January 9, 2018. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

The Deactivate action deactivates an activated server in its domain. When deactivating a server role ensure it is the same server role for the files that have been installed and activated on the server. The syntax for the Deactivate action is:

LCSCmd.exe /Server[:<Server FQDN>] /Role:<name> /Action:Deactivate [/Force]

Such as:

LCSCmd.exe /Server /Role:SE /Action:Deactivate /Force

For edge servers, the /Components parameter is required and you must specify at least one edge server component.

LCSCmd.exe /Server[:<Server FQDN>] /Role:AP /Components:AP,DP,MR /Action:Deactivate [/Force]

Such as:

LCSCmd.exe /Server /Role:AP /Components:AP,DP /Action:Deactivate 

Where:

Parameter Description

/Server

Executes the action for the specified server FQDN.

/Server - deactivates local server

/Server:<remoteComputerFQDN> - deactivates role on remote computer

/Role

Specifies the role of the server.

/Components

Specifies the component roles available on an Office Communications Server 2007, Edge Server components separated by comma. You must specify at least one server edge server role or activation will fail.

Valid values are:

  • AP to deactivate Access Edge Server

  • DP to deactivate Web Conferencing Edge Server

  • MR to deactivate A/V Edge Server

/Action

Takes a string specifying the action name. Valid action names include CheckLCServerState, Activate, Deactivate, and Diag.

/Password

Specifies the service account password for the server.

/RefDomain

Specifies the reference domain FQDN.

/Global

Specifies the global setting location.

/GroupDomain

Specifies the FQDN of the domain where Office Communications Server universal groups are located.

/Force

Specifies whether to force task execution.

/L

Specifies the log file path. If not specified, %TEMP%\<ActionName>[<Date>][<Time>].html is used. To disable logging, use a dash character (-) as the log file name.

/XML

Specifies whether the log file to be generated should be in XML format instead of HTML.

/?

Shows Help on usage.

Note

The /RefDomain switch must be used to specify which domain the Active Directory object is located in when deactivating a server if the respective computer is unavailable, such as:
LCSCmd.exe /Server:<FQDN> /Action:Deactivate /Role:SE /Refdomain:<FQDN>
The /RefDomain switch is a hint to LCSCmd.exe to look under Office Communications Server service connection objects for the existing computers Active Directory object. LCSCmd.exe will not be able to fully deactivate a server if the computer is not accessible through such events as network cuts, shut-downs, renaming, recycling, and so forth.

When you run LCSCmd.exe, the command automatically discovers the global catalog server and primary domain controllers. If you experience problems because these servers are unavailable or network connectivity is poor, you can use optional parameters to specify the global catalog server or domain controllers to use instead. For more information, see Optional LCSCmd.exe Parameters for Domain Controller and Global Catalog Server Discovery later in this document*.*