1WSL(1)                           User Commands                          WSL(1)
2
3
4

NAME

6       wsl - A shell based command line client for WSMAN servers
7
8
9

DESCRIPTION

11       wsl  (aka  "whistle")  contains  various scripts that serve as a client
12       interface to WSMAN or Web Services for  Management  protocol  based  on
13       DMTF  standard  specification. WSMAN provides standards based messaging
14       for systems management CIM-style objects.
15
16       To talk to a remote WSMAN service, start with "wsl id check". This com‐
17       mand will request the IP address, user name and password for the remote
18       server and populate a file ".wslrun" in the  current  directory.  After
19       the  first run, you can use the commands listed below without having to
20       provide IP address, user name and  password  repeatedly.  This  is  the
21       default  behavior. However, you can configure wsl so that it always ask
22       for IP address or IP address and user credential for  each  command  in
23       case you want to work with more than one target.
24
25
26       The  environmental  variables that could affect the behavior of wsl are
27       listed in README file.
28
29
30       Help information is provided at different levels. Typing "wsl" provides
31       help  information  about available commands. Typing "wsl enum" provides
32       help information about enum command and  its  parameters.  Typing  "wsl
33       enum help" gives the same information.
34
35

OPTIONS

37       e|enum|enumerate
38              Sends  SOAP message with WS-MAN ENUMERATE command. Equivalent to
39              calling "wslenum" directly.
40
41
42       id|identify
43              Sends SOAP message with WS-MAN IDENTIFY command.  Equivalent  to
44              calling "wslid" directly.
45
46
47       i|invoke
48              Sends  SOAP  message  with  WS-MAN INVOKE command. Equivalent to
49              callint "wslinvoke" directly.
50
51
52       g|get  Sends SOAP message with WS-MAN GET command. Equivalent to  call‐
53              ing "wslget" directly.
54
55
56       p|put  Sends  SOAP message with WS-MAN PUT command. Equivalent to call‐
57              ing "wslput" directly.
58
59
60       s|set  See put.
61
62
63       xcert  Command to extract SSL certificate of the server hosting WSMAN.
64
65
66       xclean Command to remove/delete the files generated by this tool.
67
68
69       xcred  Command to encrypt username and password to  a  file.  The  same
70              command  can  be used for decrypting the same file for verifica‐
71              tion. Equivalent to calling "wslcred" directly.
72
73

AUTHENTICATION

75       wsl supports basic and digest authentication  mechanism.  You  will  be
76       prompted  for  user  name  and  password at run time or you can provide
77       their values to environment variables WSUSER and WSPASS.
78
79       A more secure method is to use the light encryption method provided  by
80       wsl.  See  the  xcred  command option. It will create a credential file
81       that contains the encrypted form of the user name and password. To use,
82       simply provide the filename to WSUSER prefixed with "FILE:". You do not
83       have to provide WSPASS in this case.
84
85

FILES

87       ~/.wslrc
88              This file contains  custom  user-configurable  information  that
89              could  affect  the behavior of wsl. If not present, this file is
90              created the firt time wsl is used. Refer to README file for more
91              information.
92
93
94       $PWD/.wslrun
95              This  file contains environment variables that are populated the
96              first time wsl is run and used on subsequent runs.  It  includes
97              user  password  so  if  security  is  a  concern, try to use the
98              encrypted version (see xcred command) or you may turn  off  cre‐
99              ation  of  this  file  using  the custom user configuration (see
100              .wslrc).
101
102
104       wsl is Copyright (c) 2011, Dell Inc. License: BSD3C or similar
105
106

AUTHORS

108       Created by Chris A. Poblete <www.linkedin.com/in/chrispoblete>.
109
110
111
112
113                                                                        WSL(1)
Impressum