Export (0) Print
Expand All

Broadcast Messages

Communications Server 2007 R2

Topic Last Modified: 2009-03-11

The server context includes an action named BroadcastMessage. This action allows Office Communications Server administrators to send an alert to all SIP-enabled users or users hosted on a specific pool. The content of the message would typically be to announce service outages, virus malware, or any other kind of Office Communications Server information. Here's the syntax.

LCSCmd /Server:<Server FQDN> /Action:BroadcastMessage /Role:<SE : EE : Proxy : WorkgroupProxy : AP> [/RefDomain:<Domain FQDN> ][/PDCRequired:[TRUE|FALSE] ][/GlobalSettingsDC:<DC FQDN> ][/DC:<DC FQDN> ][/GC:<GC FQDN> ][/Global:<Configuration | System> ][/GroupDomain:<Group Domain FQDN> ][/GroupDomainDC:<Group Domain DC FQDN> ][/PoolName:<Pool Name> ][/Message:<Message Text.> ][/MessageFile:<Message Text File.> ][/MaxSession:<Maximum Session Number> ][/CertIssuer:<Certificate Issuer> ][/CertSerial:<Certificate Serial Number> ][/L:<log file path> ][/XML:[TRUE|FALSE ][/?:[TRUE|FALSE]]

Here is an example.

LCSCmd /server /action:BroadcastMessage /Role:Proxy /Message:"The system is going down for maintenance at 7:00 PM PST."

Where:

Parameter Description

/Server

Executes the action for the specified server FQDN.

/Role

Specifies the role of the server.

/Action

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

/RefDomain

Specifies the reference domain FQDN.

/PDCRequired

Specifies whether PDCs are required for the action. Default is TRUE.

/GlobalSettingsDC

FQDN of the of a global settings domain DC. This must be the local domain DC if the settings are in the configuration container, root DC is the settings are in the system container.

/Global

Specifies the global setting location. Possible values are Configuration and System.

/GroupDomain

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

/GroupDomainDC

The FQDN of a DC in the domain where Office Communications Server universal groups are located.

/PoolName

The name of the pool on which to send the message.

/Message

The text of the IM being sent.

/MessageFile

A file containing the test of the IM being sent.

/MaxSession

The maximum number of sessions (threads). The default is 10.

/CertIssuer

The name of the issuer of the trusted certificate.

/CertSerial

The serial number of the trusted certificate.

/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.

When a broadcast message is sent out, all signed-in users for a pool will be alerted. In a pool with 15,000 users signed in, the message will take up to 7 minutes to be distributed to all users. In a pool with 50,000 users signed in, you should expect the message to take up to 27 minutes to be distributed.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft