Send Welcome PIN

After enabling users for dial-in conferencing, Lync Server provides the capability for administrators to send users an e-mail message welcoming them to the service. This initial e-mail can also set and display the PIN for each user account. The welcome message can only be generated through a Lync Server Management Shell command. The actual message is based on an HTML file that can be modified to accommodate any organization. This cmdlet is included as an additional script file found in C:Program FilesCommon FilesMicrosoft Lync Server 2010ModulesLync.

When generating a welcome message, the following parameters are available:

• UserUri—The URI of the message recipient.

• From—The email address of the user sending the message.

• Subject—The subject of the email message.

• Cc—Any recipients who should be carbon copied when sending the welcome message.

• Bcc—Any recipients who should be blind carbon copied when sending the welcome message.

• TemplatePath—The file path to the template used for generating the welcome message.

• SmtpServer—The SMTP server to use when sending the message. If recipients are internal to the organization, relay capability should not be required.

• BodyAsPlainText—Specifies whether the message should be sent in plain text as opposed to HTML.

• UseSsl—Specifies whether SSL should be used when sending the message through the SMTP server.

• Pin—The PIN that should be set for the user’s account.

To send a welcome message, use the following syntax with the Lync Server Management Shell:

Set-CsPinSendCAWelcomeMail.ps1 –UserUri <SIP URI of user to set> -From <Email address of
sender> -Subject <Message subject> -Cc <Comma separated list of email addresses to be
carbon copied> -Bcc <Comma separated list of email addresses to be blind carbon copied>
-TemplatePath <File path to HTML template> -SmtpServer <Mail server address>
-BodyAsPlainText <$True | $False> -UseSsl <$True | $False> -PIN <PIN String>

Generating Bulk Welcome Messages

In reality, many users are most likely enabled for dial-in conferencing at the same time. To send this message in bulk, first create a CSV file called DialInUsers.csv with the following format:

SipUri,Pin
"sip:[email protected]",12345
"sip:[email protected]",67890

Then import the CSV and use a loop to generate a message for each user:

Import-CSV DialInUsers.csv | ForEach-Object {Set-CsPinSendCAWelcomeMail.ps1 –UserUri
$_.SipUri –From "[email protected]" -Subject "Welcome to Conferencing"
–SmtpServer
"mail.companyabc.com" –Pin $_.Pin}