1WSL(1) User Commands WSL(1)
2
3
4
6 wsl - A shell based command line client for WSMAN servers
7
8
9
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
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
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
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
108 Created by Chris A. Poblete <www.linkedin.com/in/chrispoblete>.
109
110
111
112
113 WSL(1)