|
以操作系统命令行解释器的方式执行给定的命令字符串,并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。
% Z7 L/ d' }$ [/ q; o % b: Y9 n2 i, ^' V: v" r+ o
说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时,将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。
, p! Z3 B3 A: @. Z3 Z9 s' w1 _0 D( M
- R, G5 |+ i5 v/ a; | k语法
. Q, `* p& m4 ~0 H2 _xp_cmdshell {'command_string'} [, no_output]
X! M9 s1 D+ E* J8 M8 u3 j9 X参数
9 a" k* g8 ~' i# T4 |'command_string' . w' f/ U7 p$ }9 u7 W, A
是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000),没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格,则需要使用一对引号。如果使用嵌入空格不方便,可考虑使用 FAT 8.3 文件名作为解决办法。 7 l' W! @( w3 G3 l `! u
no_output , r3 ]5 J; Y2 K7 M" i# x
是可选参数,表示执行给定的 command_string,但不向客户端返回任何输出。
, `5 O- O' d- Q! k7 C0 t返回代码值8 F; |2 A" Z5 V' u# U. U3 J6 T0 \
0(成功)或 1(失败)
8 N) b6 g! E( Y1 U R+ s$ C结果集8 j: _4 d! q0 P; U
执行下列 xp_cmdshell 语句将返回当前目录的目录列表。 xp_cmdshell 'dir *.exe'7 g) \4 L' H4 Y
+ ^1 f) r( X, Q9 U, s8 M6 _行以 nvarchar(255) 列的形式返回。 ~' Q, D: S6 K5 ? d" ?
执行下列 xp_cmdshell 语句将返回随后的结果集: xp_cmdshell 'dir *.exe', NO_OUTPUT
~. x- K' L. W1 }$ T/ Q
# R9 @7 E* v& V. J4 u$ B; X下面是结果: The command(s) completed successfully.7 g+ N% V5 [5 B$ X% y: o \
注释
) Z! X* t6 {' t1 T1 s* [$ Hxp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前,不会返回控制。 & m: f& i+ H1 Z j
当授予用户执行权限时,用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。 3 h4 p7 [- ?$ j8 g0 J M ?% Q; M: l
默认情况下,只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是,也可以授予其他用户执行此存储过程的权限。 + z% n; K0 B0 ?9 [' M4 @: X
当作为 sysadmin 固定服务器角色成员的用户唤醒调用 xp_cmdshell 时,将在运行 SQL Server 服务的安全上下文中执行 xp_cmdshell。当用户不是 sysadmin 组的成员时,xp_cmdshell 将模拟使用 xp_sqlagent_proxy_account 指定的 SQL Server 代理程序的代理帐户。如果代理帐户不能用,则 xp_cmdshell 将失败。这只是针对于 Microsoft® Windows NT® 4.0 和 Windows 2000。在 Windows 9.x 上,没有模拟,且 xp_cmdshell 始终在启动 SQL Server 的 Windows 9.x 用户的安全上下文下执行。 1 I% M7 W' ~: k9 Q$ E) H, P3 r
; @8 t) D3 d5 A5 F
说明 在早期版本中,获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server,以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中,该帐户称为 SQLAgentCmdExec。现在,不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令,而无需再进行配置更改。
8 d5 I+ i/ z0 P1 K9 B7 E" ]
/ q& ~) N9 ~4 Y9 K- X; {# p权限( R0 }) Q8 F9 D; E8 E& E
xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员,但可以授予其他用户。
0 N- }4 M$ Z1 J( d
+ g8 q# Z' e* `. a4 s4 C重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员,则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。
0 z! K) a6 a5 y% n0 v E R9 h( k) G' B
示例A. 返回可执行文件列表) Z3 G5 z1 J9 M& U0 g! A
下例显示执行目录命令的 xp_cmdshell 扩展存储过程。 EXEC master..xp_cmdshell 'dir *.exe'
1 y5 p: i6 _8 j0 | ~5 \B. 使用 Windows NT net 命令0 X, ^8 `3 u4 H# w( Q& W
下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭,然后用 net pause 暂停服务器,最后用 net stop 关闭服务器。 CREATE PROC shutdown103 W4 L9 @, `- {
AS
( ~& Y0 `. a$ Q: O& {' EEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
7 t$ ^ T9 n* T9 Z' _2 l in 10 minutes. No more connections allowed.', no_output. P p8 `7 W6 p
EXEC xp_cmdshell 'net pause sqlserver'. P" f7 [* F0 G" ]
WAITFOR DELAY '00:05:00'. X7 d3 B9 o) Z4 r
EXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down & @+ Q+ X$ A3 a$ z' U. s
in 5 minutes.', no_output
1 E: |) j9 w1 z5 |9 ]WAITFOR DELAY '00:04:00'
& H6 X4 x/ V- @/ v" KEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down # U% M4 p9 p5 F' d- i& \
in 1 minute. Log off now.', no_output# h' N8 w4 Z B
WAITFOR DELAY '00:01:00'/ v! e3 w) J2 [* h' B
EXEC xp_cmdshell 'net stop sqlserver', no_output# U+ m- r; q& n, F( l
C. 不返回输出 : R1 d. L0 R. P2 o" b3 |! a
下例使用 xp_cmdshell 执行命令字符串,且不向客户端返回输出。 USE master; q/ A* G* v/ ^ s! h7 u) E, z
EXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
5 {1 e9 \3 O' u; ] NO_OUTPUT
1 m# H7 ~* ?( }- @! d& v1 |7 I& ]D. 使用返回状态- p) t' {7 f4 G3 Q
在下例中,xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。 DECLARE @result int5 ?2 [) X/ P: P5 Q6 N3 D4 w
EXEC @result = xp_cmdshell 'dir *.exe'
3 m" O4 u) n4 ?0 ?9 h7 W, e& N! b$ OIF (@result = 0)& _- B2 p9 t5 d% y, M4 O5 u: c- l
PRINT 'Success'. n6 L- Z/ _& R" \& q) M/ i$ _& k
ELSE
+ ]8 R* L! b, |, I5 \$ y PRINT 'Failure') F, j6 Q5 c2 q* g5 c
E. 将变量内容写入文件
# y0 |8 Y3 p7 h ~$ h1 }' p% a下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname. J' ]0 `# \7 Z
SET @var = 'Hello world'
) R. n4 y. d& U) W- PSET @cmd = 'echo ' + @var + ' > var_out.txt'0 s; i- S Q& Z: h1 V
EXEC master..xp_cmdshell @cmd
3 V8 _. G5 P' s$ V" T6 jF. 将命令的结果捕获到文件
! r) r( n! X4 u4 B! e下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname5 p2 Y+ h7 v4 `7 V W9 }; a
SET @var = 'dir/p'7 U" w, U* K8 B( j& F& U0 O
SET @cmd = @var + ' > dir_out.txt'4 b# T( |9 o, c1 I! L
EXEC master..xp_cmdshell @cmd
1 ~+ X- E" x P7 J0 B2 S0 C6 N; g4 E$ q4 x( O2 ]/ j7 C( m: s2 I
/ Z0 e, I0 f7 B; H( A/ ~请参见
9 B* h2 L5 a, I) M1 O; d# C/ m2 r( x
, M3 d5 N+ a' `, }& y sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE ( \3 S# C j1 U$ B/ E+ e6 K( S: W
sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE
2 b: e; S( m% e$ D创建安全帐户
* J% @8 O8 [% p0 ^$ I( R$ Usqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程(常规扩展过程) 7 m/ q( W) W; Q% h0 ?. G
. f% \- P5 S% _) ?* w0 }3 T1 j) n
/ k( I* o" ]- _* T2 r% l) l |