1WINEXE(1) User Commands WINEXE(1)
2
6 winexe - Winexe is a Remote Windows-command executor
7
9 winexe [-h] [-V] [-U [DOMAIN/]USERNAME[%PASSWORD]] [-A FILE] [-N] [-k]
10 [-d DEBUGLEVEL] [--uninstall] [--reinstall]
11 [--runas [DOMAIN/]USERNAME[%PASSWORD]] [--runas-file FILE]
12 [--interactive [0|1]] [--ostype [0|1]]
13
15 This tool is part of the samba(7) suite.
16 The winexe allows remote command execution on native Windows operating
18 systems.
19
21 -?|--help
22 Print a summary of command line options.
23 -V|--version
25 Prints the program version number.
26 -U|--user=username[%password]
28 Sets the SMB username or username and password.
29 If %password is not specified, the user will be prompted. The
31 client will first check the USER environment variable, then the
32 LOGNAME variable and if either exists, the string is uppercased. If
33 these environmental variables are not found, the username GUEST is
34 used.
35 A third option is to use a credentials file which contains the
37 plaintext of the username and password. This option is mainly
38 provided for scripts where the admin does not wish to pass the
39 credentials on the command line or via environment variables. If
40 this method is used, make certain that the permissions on the file
41 restrict access from unwanted users. See the -A for more details.
42 Be cautious about including passwords in scripts. Also, on many
44 systems the command line of a running process may be seen via the
45 ps command. To be safe always allow rpcclient to prompt for a
46 password and type it in directly.
47 -A|--authentication-file=filename
49 This option allows you to specify a file from which to read the
50 username and password used in the connection. The format of the
51 file is
52 username = <value>
54 password = <value>
55 domain = <value>
56 Make certain that the permissions on the file restrict access from
58 unwanted users.
59 -N|--no-pass
61 If specified, this parameter suppresses the normal password prompt
62 from the client to the user. This is useful when accessing a
63 service that does not require a password.
64 Unless a password is specified on the command line or this
66 parameter is specified, the client will request a password.
67 If a password is specified on the command line and this option is
69 also defined the password on the command line will be silently
70 ignored and no password will be used.
71 -k|--kerberos
73 Try to authenticate with kerberos. Only useful in an Active
74 Directory environment.
75 -d|--debuglevel=level
77 level is an integer from 0 to 10. The default value if this
78 parameter is not specified is 1.
79 The higher this value, the more detail will be logged to the log
81 files about the activities of the server. At level 0, only critical
82 errors and serious warnings will be logged. Level 1 is a reasonable
83 level for day-to-day running - it generates a small amount of
84 information about operations carried out.
85 Levels above 1 will generate considerable amounts of log data, and
87 should only be used when investigating a problem. Levels above 3
88 are designed for use only by developers and generate HUGE amounts
89 of log data, most of which is extremely cryptic.
90 Note that specifying this parameter here will override the log
92 level parameter in the smb.conf file.
93 --uninstall
95 Uninstall winexe service after remote execution.
96 --reinstall
98 Reinstall winexe service before remote execution.
99 --runas [DOMAIN/]USERNAME[%PASSWORD]]
101 Run as the given user (BEWARE: this password is sent in cleartext
102 over the network!)
103 --runas-file FILE
105 Run as user options defined in a file.
106 --interactive [0|1]
108 Desktop interaction.
109 There are two options:
111 · 0 - disallow
113 · 1 - allow. If allow, also use the --system switch
115 (Windows requirement). Vista does not support this
116 optoin.
117 --ostype [0|1|2]
120 Determines which version (32-bit or 64-bit) of service will be
121 installed.
122 There are three options:
124 · 0 - 32-bit
126 · 1 - 64-bit
128 · 2 - winexe will decide
130
133 The winexe program returns 0 if the operation succeeded, or 1 if the
134 operation failed.
135
137 This man page is part of version 4.13.7 of the Samba suite.
138
140 The original Samba software and related utilities were created by
141 Andrew Tridgell. Samba is now developed by the Samba Team as an Open
142 Source project similar to the way the Linux kernel is developed.
143 The winexe and it's native Windows counterpart were written by Andrzej
145 Hajda. The Samba client tool winexe was later rewritten by Volker
146 Lendecke.
147 This manpage was written by Guenther Deschner.
149Samba 4.13.7 03/25/2021 WINEXE(1)