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