|
以操作系统命令行解释器的方式执行给定的命令字符串,并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。 # |7 d, ^7 B# n' w4 o6 F* k6 i
7 Z1 N1 j$ i3 L6 u0 G6 f说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时,将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。
* N% _1 n" y8 ]4 f. U/ B5 w9 _
1 \* Q4 G: D% I7 K K: X
% n) ~# ~) [/ i5 z8 o" X语法& ]( V/ v; J( g* K) N5 n! z
xp_cmdshell {'command_string'} [, no_output] 4 A. F5 v! ~) S- O
参数" J) h S$ P5 J2 ]; l6 B& e
'command_string'
- M6 Z9 J4 y8 X% F1 Y是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000),没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格,则需要使用一对引号。如果使用嵌入空格不方便,可考虑使用 FAT 8.3 文件名作为解决办法。 ) R# G" T8 O( k& C& t' H7 |
no_output
# E5 P' @5 t% t; y4 s- ?; B是可选参数,表示执行给定的 command_string,但不向客户端返回任何输出。
+ X' g; W8 E* F9 U5 w, m# b返回代码值
7 s0 ~* u; n" N+ i6 c: k0(成功)或 1(失败) ( d4 e* J |8 I/ \) R
结果集
! a- {/ x A2 k6 p( [执行下列 xp_cmdshell 语句将返回当前目录的目录列表。 xp_cmdshell 'dir *.exe'( m7 k- q2 Y! L* r( Z7 i
1 F4 c5 E4 }1 p" e1 H, O) M) H p) `9 D
行以 nvarchar(255) 列的形式返回。
, k8 ^& S3 I" A执行下列 xp_cmdshell 语句将返回随后的结果集: xp_cmdshell 'dir *.exe', NO_OUTPUT
5 ~2 ]( _$ g6 l7 I) ]% Y5 u6 v& R6 g7 t
下面是结果: The command(s) completed successfully.
4 l+ F/ I: i( u! I& z" y注释
+ I! E! B/ E, S" p5 Yxp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前,不会返回控制。 3 |: W4 Y3 \/ I: ]! D
当授予用户执行权限时,用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。
1 {( J( c% ~0 f% ]9 E8 x默认情况下,只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是,也可以授予其他用户执行此存储过程的权限。 # m: s9 G" e' t6 V7 ^) |
当作为 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 用户的安全上下文下执行。 3 c1 Q! ^* p& m! H/ ] ~+ H
% F0 @; O' {% w. `
说明 在早期版本中,获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server,以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中,该帐户称为 SQLAgentCmdExec。现在,不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令,而无需再进行配置更改。7 l# y5 b$ h9 l7 i! ]
/ J6 m% f( u) p) C权限
: r: }7 f4 C! ~7 u0 c xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员,但可以授予其他用户。 " ?3 Y) S" V5 j& e0 @; l e
, R% v8 w: n6 O& L* x
重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员,则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。
; n1 ?, j& N: R( U# }. w: n$ F; g, ?- R5 |. d. h( ^ F, e
示例A. 返回可执行文件列表
$ O9 Q7 }) e8 | 下例显示执行目录命令的 xp_cmdshell 扩展存储过程。 EXEC master..xp_cmdshell 'dir *.exe'4 i$ `' m, M8 g$ k: F1 S
B. 使用 Windows NT net 命令3 _6 g1 K7 k0 ?3 j
下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭,然后用 net pause 暂停服务器,最后用 net stop 关闭服务器。 CREATE PROC shutdown106 |% v1 \' K+ y
AS- t: O. N: Y8 a& J$ `
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down $ V+ x/ v# g9 J1 j
in 10 minutes. No more connections allowed.', no_output) ]) `, [% }& y! P( ]* T1 ^
EXEC xp_cmdshell 'net pause sqlserver'
3 [. c4 S# F, UWAITFOR DELAY '00:05:00'' [( B6 U* w- B: \( S
EXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down
7 j4 H) A) u! `- ^$ l in 5 minutes.', no_output
5 T/ Q- }; H& q0 }7 {WAITFOR DELAY '00:04:00'4 |7 Z# G" Z5 Y/ G
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
! z8 A5 W- [7 k; p% D. F: U in 1 minute. Log off now.', no_output
2 e& I9 M5 t; j( d2 P, YWAITFOR DELAY '00:01:00'. |- B3 A3 H. d: K
EXEC xp_cmdshell 'net stop sqlserver', no_output
2 m" j3 k- L& Z8 |C. 不返回输出 0 V4 x1 g' `' _( x
下例使用 xp_cmdshell 执行命令字符串,且不向客户端返回输出。 USE master
+ f8 E# Z" O T5 k, B, vEXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
/ i8 E g- {6 `$ o, Q2 u NO_OUTPUT
# E7 s9 a' R) g! uD. 使用返回状态) Y- _) l- H3 ]
在下例中,xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。 DECLARE @result int
' ~) e% F. a2 _EXEC @result = xp_cmdshell 'dir *.exe'( ~$ ?3 b# Q& W5 P
IF (@result = 0)
' ~+ R6 J/ E& g PRINT 'Success'3 m- g* l7 p, k9 Q# b
ELSE
: S# g3 Z- m; Q" x& \ PRINT 'Failure'
$ C" Y. F% b- g" vE. 将变量内容写入文件 ( M* s. L7 K( P/ b: l* S8 O, `
下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname
6 ]3 U) J% c, x0 L+ |# Z7 MSET @var = 'Hello world'
$ E- |& ]7 H" D- I% e BSET @cmd = 'echo ' + @var + ' > var_out.txt'# U3 A% A& H+ @$ Y% C
EXEC master..xp_cmdshell @cmd
. y. p2 E$ e/ K5 AF. 将命令的结果捕获到文件5 \% i/ e' s. R, R
下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname
- u( @% [! g/ h3 ^SET @var = 'dir/p'" X9 i4 O, k. ^7 K; c; ?4 @
SET @cmd = @var + ' > dir_out.txt'7 S$ o1 l* m0 d5 y4 W" W# r2 Z- @
EXEC master..xp_cmdshell @cmd9 c. O' d* i Q; b
0 M( v6 \ ]9 ?' S/ I4 C5 h1 x
7 Q1 F) @0 g' L l* u请参见
) c! @& m) {# F( C$ n! U
2 J x" y: n, u5 ]! X sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE
, f! f( m' Q. k) y+ b. hsqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE
& U! p- \7 K0 U" S创建安全帐户 ( {/ r/ ]* v6 o( ]. r O/ V- l( B
sqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程(常规扩展过程) H3 i x6 G2 h3 W- {0 S9 N
* s7 B: u: s8 c4 T
1 Z4 ?6 @. u1 O! L( W" R# w |