|
以操作系统命令行解释器的方式执行给定的命令字符串,并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。
$ j1 F# a0 X) J$ A7 C. j - u8 x$ Z* D% v( M4 Q/ W
说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时,将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。
9 X/ i, I8 X; a7 q ~3 H' b7 @, q
" P( x: M ~- Z4 v. t7 w
4 R! Y) N6 F, N" l% Y E+ u语法
# I5 C* k: r: r- l- H' f; \" S: _$ J# [ exp_cmdshell {'command_string'} [, no_output] , Q8 e$ _' T9 T4 T
参数5 V$ u* V- N) e5 k5 K: j1 N
'command_string' 0 C* r+ A3 a' K1 ~ ^: z; k
是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000),没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格,则需要使用一对引号。如果使用嵌入空格不方便,可考虑使用 FAT 8.3 文件名作为解决办法。 # |: K* y" T6 F
no_output
3 R& V1 f: g1 d是可选参数,表示执行给定的 command_string,但不向客户端返回任何输出。
. {" \$ A, g. x. ^& d8 \5 o返回代码值
: P: ?$ y3 C: e8 G4 B$ j4 z6 J5 g0(成功)或 1(失败)
6 r0 G- U/ i1 o8 y结果集, [/ {$ j) n6 Q( o. o' r
执行下列 xp_cmdshell 语句将返回当前目录的目录列表。 xp_cmdshell 'dir *.exe'
% R% p9 r O% q: K- D6 J, h4 `( T9 g
行以 nvarchar(255) 列的形式返回。
% H5 ^0 W6 [0 e, U5 Z% C/ d( M执行下列 xp_cmdshell 语句将返回随后的结果集: xp_cmdshell 'dir *.exe', NO_OUTPUT0 \' k, Z9 y% P% M
2 D- _ p% O7 U; X! v# e下面是结果: The command(s) completed successfully.& i5 H1 b4 w) l0 `
注释9 e" H2 b; X* _( Q" v
xp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前,不会返回控制。
. T# U0 h+ f6 H% H A当授予用户执行权限时,用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。 5 |1 n! |3 j6 l' C& z3 v8 j
默认情况下,只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是,也可以授予其他用户执行此存储过程的权限。
# `5 S7 [% j r9 u5 Z; l" ~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 用户的安全上下文下执行。 - I; R) O7 j# @
2 @/ U {3 f* L f+ F说明 在早期版本中,获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server,以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中,该帐户称为 SQLAgentCmdExec。现在,不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令,而无需再进行配置更改。
; X7 [8 ?/ K2 t$ W( l0 `( h4 q0 I, O$ C2 H, }) M8 u5 `$ d$ `
权限" K' L1 X+ h& F3 V( @
xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员,但可以授予其他用户。
@8 @9 P4 \" W5 y, w 8 P/ a. D! b4 v2 T1 n8 R7 s2 i) n
重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员,则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。% v' x+ V" _8 _) Y
% |8 ^3 w4 `9 w$ y) ]# e' M0 ^) h示例A. 返回可执行文件列表
) T! g3 X/ d1 _ k* T 下例显示执行目录命令的 xp_cmdshell 扩展存储过程。 EXEC master..xp_cmdshell 'dir *.exe'. p- c6 q- G/ |" [% X
B. 使用 Windows NT net 命令
" S5 z$ M: }& ^4 S. h5 k6 ?下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭,然后用 net pause 暂停服务器,最后用 net stop 关闭服务器。 CREATE PROC shutdown10/ A4 `! h' p" L' c
AS" h: a5 ]4 p+ n
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
) s9 r+ a0 t' D5 b3 e0 V in 10 minutes. No more connections allowed.', no_output
- Q! i" C4 z7 Y UEXEC xp_cmdshell 'net pause sqlserver'9 j6 X0 L' r9 P+ {* I
WAITFOR DELAY '00:05:00'& |4 e# B$ a) \- _$ i
EXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down
2 f' I" d! L0 E! Z* K in 5 minutes.', no_output
0 z% I4 X$ k! X+ h, oWAITFOR DELAY '00:04:00'2 c9 l9 t1 [. {
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
, Q& x0 |0 x& Q+ Q# X, q in 1 minute. Log off now.', no_output
* g' s0 ]( i C: sWAITFOR DELAY '00:01:00'
5 T, o# o+ p6 B5 O2 ]+ |$ qEXEC xp_cmdshell 'net stop sqlserver', no_output1 x$ y; R1 B% @8 @% P
C. 不返回输出 $ S6 u) P# r1 t3 |0 B: }
下例使用 xp_cmdshell 执行命令字符串,且不向客户端返回输出。 USE master
2 B- K$ u$ M" ~, k6 F8 n3 C6 Q# bEXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
8 J1 c8 l. Y7 ^, B; M NO_OUTPUT
) W' r9 y$ x# GD. 使用返回状态
0 O) `9 w6 r" Z$ J; A% U" K在下例中,xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。 DECLARE @result int0 l5 p- p$ T B) f9 [
EXEC @result = xp_cmdshell 'dir *.exe'/ @! P8 f& G* T9 }" `' N9 ]$ ?
IF (@result = 0)+ u9 A) o; I& P! ?! X8 v
PRINT 'Success'
4 G- T$ l3 s7 ~3 T1 u' J- ?ELSE) ~) v0 c, H: k$ N( p1 s
PRINT 'Failure'7 b3 k. x0 _: t/ _
E. 将变量内容写入文件 ! E2 C. A; a. M8 E. n9 x
下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname
" N" }! [) H1 r3 xSET @var = 'Hello world'
5 } w- c/ T- HSET @cmd = 'echo ' + @var + ' > var_out.txt'
9 g# h2 H% m6 T# p4 \EXEC master..xp_cmdshell @cmd+ Q! r0 W$ z( I0 T% N, d
F. 将命令的结果捕获到文件
. s: ~" R0 k3 L3 P$ @7 z下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname0 s7 x( M9 p: d! F. R% T0 V1 C* K
SET @var = 'dir/p'
& ?7 s! ?& W; dSET @cmd = @var + ' > dir_out.txt'
5 u/ }+ @2 I6 o& T& i+ a& h- i5 jEXEC master..xp_cmdshell @cmd, y, F0 J, f7 u1 F, J1 J
$ E) i1 ?3 f) T9 m
* K+ E% J3 }. c
请参见6 r% ^0 k( d+ a5 k
1 O8 V3 l+ G }3 O6 K sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE , l0 V8 E8 b, I7 q* B
sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE
( v: R9 V3 ~+ t: |8 d9 _创建安全帐户 ( X8 }) B2 }$ n
sqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程(常规扩展过程)
0 [. f0 A- E) p, y: k7 |0 G9 E( s. X
" {: v# D3 s/ M# O4 d5 I |