This document was published at: http://support.citrix.com/article/CTX112588
Document ID: CTX112588, Created on: Apr 13, 2007, Updated: Apr 13, 2007
Products: N/A
Attachment: DynamicUSB.zip (40.9 K)
I hope all is well around the world. TSMsg is yet another freeware tool I wrote from the requests of the thin community around the world.
TSMsg is a command-line tool to message Citrix or Terminal Server
Sessions on any server within a Domain.
This utility was written to replace the command MSG.EXE currently found in the MS Windows Operating System. This utility offers an extra feature that will be of benefit to all admins - the /SERVER:* switch.
Using this switch, an administrator can message all users on all Citrix/TS servers with one command or multiple servers with a common structure e.g. /Server:MySer*. This command can also be used in a script.
This utility is FREEWARE and was written by Warren Simondson of Ctrl-Alt-Del IT Consultancy, Australia. www.ctrl-alt-del.com.au
Thank you to the WINDOWS SDK available from http://msdn.microsoft.com/downloads
Usage:
TSMsg [UserName | SessionID | *] [/SERVER:servername | *] [Message]
UserName - Identifies recipient of the message
(NOT case sensitive)
SessionID - [Optional] Identifies Session ID of recipient of the message
* - [Optional] Send message to ALL users on chosen server
/SERVER:servername - [Optional] Specifies the Terminal server containing the user session to send message (default is current).
/SERVER:* - [Optional] Send message to ALL servers for the chosen
user/s
Message - [Optional] The message to send. If none is specified,
sends a test message.
/? - This help information.
E.G. TSMsg Bob My test message
This command will message the user BOB on the current TS or Citrix Server within the current Domain.
E.G. TSMsg Mary /Server:MyServer My test message
This command will message the user Mary on the TS or Citrix Server called MyServer within the current Domain.
E.G. TSMsg 5 /Server:MyServer My test message
This command will message session ID 5 on the TS or Citrix Server called MyServer within the current Domain.
E.G. TSMsg * /Server:MyServer My test message
This command will message all users on the TS or Citrix Server called MyServer within the current Domain.
E.G. TSMsg * /Server:* My test message
This command will message all users on all TS or Citrix Servers within the current Domain.
E.G. TSMsg * /Server:MySer* My test message
This command will message all users on any TS or Citrix Server with a server name beginning with MySer within the current Domain.
i.e. MyServer, MyServer1, MySerdemo.
You assume all responsibility for any damages or lost data that may result from any errors or bugs in TSMsg.
Warren Simondson
Ctrl-Alt-Del IT Consultancy Pty Ltd
ENVTSCIP is a minor extension of GETTSCIP whereby it sets the client IP address of a user session to an environment variable called CLIENTIP.
This utility was written due to the high demand in emails asking Ctrl-Alt-Del IT Consultancy to produce this tool.
There are another 5 Utilities in the pipeline all due out soon.
As always, get the utilities from http://www.ctrl-alt-del.com.au/CAD_Utils.htm
ENVTSCIP is a command-line tool for Terminal Servers to query the current session's client ip address and display it in the command line, as well as set it to a VOLATILE ENVIRONMENT
VARIABLE - %CLIENTIP%. This utility is FREEWARE and was written by Warren Simondson ofCtrl-Alt-Del IT Consultancy, Australia. http://www.ctrl-alt-del.com.au/Thankyou to the WINDOWS SDK available from http://msdn.microsoft.com/downloadsUsage: ENVTSCIP E.G. ENVTSCIPThis command will return the client ip address of a session as:WTSClientAddress: 192.168.0.141 and also store it as an environment variable %CLIENTIP%
E.G. ENVTSCIP>ipaddress.txt
This command will return the client ip address of a session as: WTSClientAddress: 192.168.0.141 and store it in the text file ipaddress.txt.
It will also store it as an environment variable %CLIENTIP% Using ENVTSCIP in assigning an Environment Variable is best executed from startup or the RUN section located in the registry.
This will ensure it can be used throughout an active session. For using ENVTSCIP in logon scripts, please see ENVTSCIP.txt included in this package.
The freeware version is offered AS IS. Ctrl-Alt-Del IT Consultancy has made every effort possible to ensure that ENVTSCIP is free of any bugs or errors, however in no way is ENVTSCIP to be considered error or bug free. You assume all responsibility for any damages or lost data that may result from any errors or bugs in ENVTSCIP. IN NO EVENT WILL CTRL-ALT-DEL IT CONSULTANCY BE LIABLE TO YOU FOR ANY GENERAL, SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR OTHER DAMAGES ARISING OUT OF THIS PRODUCT.
USRLOGON.CMD EXAMPLE====================
@Echo Off
:: call the client ip utility that assigns the environment variable
call "%SystemRoot%\System32\envtscip.exe"
::Becasue this is run in usrlogon.cmd, the environment variable cannot be broadcast to the windows shell
::thus we use the old classic Terminal Server tool ACRegL to enforce the variable during the logon script
"%systemroot%\Application Compatibility Scripts\ACRegL.exe" "%TEMP%\getpaths.cmd" CLIENTIP "HKCU\Volatile Environment" "CLIENTIP" ""
If Not ErrorLevel 1 Goto Cont1
Echo.
Echo Unable to retrieve path.
Echo.
Goto Finish
:Cont1
Call "%TEMP%\getpaths.cmd"
Del "%TEMP%\getpaths.cmd" >Nul: 2>&1
::The environment variable %clientip% can now be used throughout this script
::To use the environment variable %clientip% within a session run ENVTSCIP.exe in the startup of the user's session
::or the RUN section of the registry
::just as a test echo the variable to the screen
echo %CLIENTIP%
:Finish
Warren Simondson
Ctrl-Alt-Del IT Consultancy Pty Ltd
