man wsl (1): A shell based command line client for WSMAN servers

DESCRIPTION

wsl (aka "whistle") contains various scripts that serve as a client interface to WSMAN or Web Services for Management protocol based on DMTF standard specification. WSMAN provides standards based messaging for systems management CIM-style objects.

To talk to a remote WSMAN service, start with "wsl id check". This command will request the IP address, user name and password for the remote server and populate a file ".wslrun" in the current directory. After the first run, you can use the commands listed below without having to provide IP address, user name and password repeatedly. This is the default behavior. However, you can configure wsl so that it always ask for IP address or IP address and user credential for each command in case you want to work with more than one target.

The environmental variables that could affect the behavior of wsl are listed in README file.

Help information is provided at different levels. Typing "wsl" provides help information about available commands. Typing "wsl enum" provides help information about enum command and its parameters. Typing "wsl enum help" gives the same information.

OPTIONS

e|enum|enumerate: Sends SOAP message with WS-MAN ENUMERATE command. Equivalent to calling "wslenum" directly.
id|identify: Sends SOAP message with WS-MAN IDENTIFY command. Equivalent to calling "wslid" directly.
i|invoke: Sends SOAP message with WS-MAN INVOKE command. Equivalent to callint "wslinvoke" directly.
g|get: Sends SOAP message with WS-MAN GET command. Equivalent to calling "wslget" directly.
p|put: Sends SOAP message with WS-MAN PUT command. Equivalent to calling "wslput" directly.
s|set: See put.
xcert: Command to extract SSL certificate of the server hosting WSMAN.
xclean: Command to remove/delete the files generated by this tool.
xcred: Command to encrypt username and password to a file. The same command can be used for decrypting the same file for verification. Equivalent to calling "wslcred" directly.

AUTHENTICATION

wsl supports basic and digest authentication mechanism. You will be prompted for user name and password at run time or you can provide their values to environment variables WSUSER and WSPASS.

A more secure method is to use the light encryption method provided by wsl. See the xcred command option. It will create a credential file that contains the encrypted form of the user name and password. To use, simply provide the filename to WSUSER prefixed with "FILE:". You do not have to provide WSPASS in this case.

FILES

~/.wsl-config: This file contains custom user-configurable information that could affect the behavior of wsl. If not present, this file is created the firt time wsl is used. Refer to README file for more information.
$PWD/.wslrun: This file contains environment variables that are populated the first time wsl is run and used on subsequent runs. It includes user password so if security is a concern, try to use the encrypted version (see xcred command) or you may turn off creation of this file using the custom user configuration (see .wsl-config).

COPYRIGHT

AUTHORS