NAME

       wsl - 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

       wsl is Copyright (c) 2011, Dell Inc. License: BSD3C or similar

AUTHORS

       Created by Chris A. Poblete <www.linkedin.com/in/chrispoblete>.

                                                                                                          WSL(1)