|
以操作系统命令行解释器的方式执行给定的命令字符串,并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。
! ?; ?- o3 I+ z7 m
& N% j, S4 i# F# q3 t3 M说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时,将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。! p/ v: b [0 S, ^/ Y- f3 G2 q
8 F* e2 j/ s& b% I2 J
8 ~* T5 \& z5 c$ @
语法& A( a+ m7 \9 c1 z$ h( A' d, A
xp_cmdshell {'command_string'} [, no_output]
$ O) [9 h* b% a8 y参数
% k( f1 C$ {# P'command_string'
) b& \$ I9 d* s9 Z7 ]2 F是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000),没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格,则需要使用一对引号。如果使用嵌入空格不方便,可考虑使用 FAT 8.3 文件名作为解决办法。 0 r @9 y: k% C2 d" q
no_output 9 x! j- a( U Z k6 w% E0 ~& e! @; Y Q
是可选参数,表示执行给定的 command_string,但不向客户端返回任何输出。
0 b9 k% g: f: P4 x, l2 G) ?( v返回代码值7 p5 v! {, K. C$ F3 w6 Q: X
0(成功)或 1(失败)
* M9 [7 {7 p& c结果集) R7 w6 h2 K, }: |+ Z- G
执行下列 xp_cmdshell 语句将返回当前目录的目录列表。 xp_cmdshell 'dir *.exe'
y/ F/ Q1 B+ F5 H& `. S; N0 A( h+ X$ `
行以 nvarchar(255) 列的形式返回。 . F" N! @# l, c/ K( W( p" w. _
执行下列 xp_cmdshell 语句将返回随后的结果集: xp_cmdshell 'dir *.exe', NO_OUTPUT! ?; S4 K# g: V+ ]/ K3 q
# F8 c, s- u: U9 ^ d) d$ k; b下面是结果: The command(s) completed successfully.
" n+ m( e/ d. j/ P# r. _+ d注释
# y6 h' ^+ A+ N8 a8 j0 u/ b# n0 xxp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前,不会返回控制。
% C, d3 n+ l5 |3 H' z' K+ p当授予用户执行权限时,用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。
, d! b6 I/ ~7 f+ ?默认情况下,只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是,也可以授予其他用户执行此存储过程的权限。
- z+ S) f2 | R6 _! ^8 @当作为 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 用户的安全上下文下执行。 9 u& j- p1 N g, W) w2 Q
5 \& w S* `, o" g( U
说明 在早期版本中,获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server,以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中,该帐户称为 SQLAgentCmdExec。现在,不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令,而无需再进行配置更改。
4 E z8 @- P( |9 f4 H2 E, `8 b1 {* ^) s$ e
权限 D s9 q8 F" A! [/ r) J( X
xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员,但可以授予其他用户。 / v, p# z- z* z
! L. l3 p8 \. C2 Q6 W9 K, R重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员,则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。& w% Y; u' n A0 S* K( ^
0 E8 V% U3 H2 m4 n
示例A. 返回可执行文件列表3 V R$ ?+ \: a9 B# u
下例显示执行目录命令的 xp_cmdshell 扩展存储过程。 EXEC master..xp_cmdshell 'dir *.exe'4 u& J1 P4 U. e) `0 D
B. 使用 Windows NT net 命令 b* K$ ]. R% }1 R9 B6 y1 j
下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭,然后用 net pause 暂停服务器,最后用 net stop 关闭服务器。 CREATE PROC shutdown10# f" r' c, [( C6 y5 y4 H9 T2 O' Q
AS: m- X6 S6 s+ }1 p. d. S
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
% p+ f3 u0 ~! U) a# f in 10 minutes. No more connections allowed.', no_output
' y1 Y0 Q% I3 G; JEXEC xp_cmdshell 'net pause sqlserver'
# `6 [8 Z" C4 S9 d& jWAITFOR DELAY '00:05:00'
9 m6 _+ q# X& f$ ~3 {" Y. sEXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down
' |( f+ i( W, k' P- W! \; \( @* b in 5 minutes.', no_output, s" }3 G7 ]: x7 v. R
WAITFOR DELAY '00:04:00'. o7 X2 O$ s" k: s2 \. a7 @5 G
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down 0 F- W- }( D1 s$ Q
in 1 minute. Log off now.', no_output
' Z+ w5 M! K6 hWAITFOR DELAY '00:01:00'/ [( |0 ]0 e& N4 c+ X1 W; d
EXEC xp_cmdshell 'net stop sqlserver', no_output
8 k! a" T) h! l2 V4 g/ ~; P6 xC. 不返回输出
9 d( N8 S% B% k4 T- D3 Q- g下例使用 xp_cmdshell 执行命令字符串,且不向客户端返回输出。 USE master
2 ~( g5 Y! M/ gEXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
4 }+ P" o" F0 q. O NO_OUTPUT
- W) n+ f c2 f! a5 DD. 使用返回状态# F$ V8 p/ |- ^/ B
在下例中,xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。 DECLARE @result int
% `! q' F0 e" ?* y+ ~5 a! X- uEXEC @result = xp_cmdshell 'dir *.exe' b; i% ?- k- ^4 l$ }
IF (@result = 0). F! T! v8 n; a2 u
PRINT 'Success'
# o3 b1 J: p# _1 ?2 e |& Q' ~4 HELSE
: ~' S- S# J1 E PRINT 'Failure'! h [" L( p% @7 L8 L1 |# b
E. 将变量内容写入文件 5 M2 q! m K$ m9 G6 S
下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname
# a" v1 g1 S/ z+ zSET @var = 'Hello world'
$ E+ @* g$ P( A5 l1 @. {; zSET @cmd = 'echo ' + @var + ' > var_out.txt'$ Z8 r5 |/ z4 w$ y: b
EXEC master..xp_cmdshell @cmd
! D. O; m, I* R' p* z" XF. 将命令的结果捕获到文件
7 L7 k! f3 Z* s1 t V下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname
. d1 ~2 E2 h4 a* r f, HSET @var = 'dir/p'
. J9 w- |4 |. Z# b t* Z, pSET @cmd = @var + ' > dir_out.txt'
2 {! L" y& k4 }3 QEXEC master..xp_cmdshell @cmd) L; c- N6 \2 ~! f
4 H: e7 g g+ b3 K' \7 g! O- [! `
' u2 r1 M: b/ P. l请参见
2 P: C1 v/ E, _% e# _ 4 O: h/ a. B# U: }9 b% u6 X ^
sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE 9 m$ U7 V1 L j
sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE 8 k3 R2 @' {2 B) `$ j' I C
创建安全帐户
Z7 P1 u8 e. S1 wsqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程(常规扩展过程)
' }* H+ M. p/ y; E
+ W' v/ @0 j' [! W( l( J& r' C; s3 @# I' F x2 o9 V
|