|
以操作系统命令行解释器的方式执行给定的命令字符串,并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。
! e8 ^- M$ V1 l) G+ [; U t # w E g4 V9 O; E$ k6 \
说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时,将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。% A/ l+ G5 }6 l6 Y C
7 J, k$ j2 h' m$ E
8 C' T( Q) ~) N% f& Y3 X语法7 J m/ k4 m2 U/ K+ G( K5 K. D
xp_cmdshell {'command_string'} [, no_output] V8 a3 V1 ^& }6 ~
参数
F+ f% |! J- a+ e& R'command_string'
2 Q) q L- O/ y是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000),没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格,则需要使用一对引号。如果使用嵌入空格不方便,可考虑使用 FAT 8.3 文件名作为解决办法。
& f; ]" z$ Y5 R C) i7 v/ kno_output . X+ e. X' ?1 q* T5 V
是可选参数,表示执行给定的 command_string,但不向客户端返回任何输出。 , Y6 U, A5 F9 s
返回代码值
* _6 o: ]) n6 a; N% @# N) o9 X% `0(成功)或 1(失败)
! ~9 V. L6 h( U7 n! M结果集+ {" W8 u W9 O6 @4 K. {2 p! c
执行下列 xp_cmdshell 语句将返回当前目录的目录列表。 xp_cmdshell 'dir *.exe'" N6 N# ~# w ]5 z, R' n9 q6 Y
- P! [ f) Q) y9 w- ]: ~行以 nvarchar(255) 列的形式返回。 ' E6 A1 L! ~0 w2 G' k
执行下列 xp_cmdshell 语句将返回随后的结果集: xp_cmdshell 'dir *.exe', NO_OUTPUT
g" h; f/ C" }" A
9 C/ M( e ^5 }6 k( W下面是结果: The command(s) completed successfully.! I: p8 T2 x" C! W8 P' g( t
注释. r- r/ |2 E3 B# ^* t! q: [
xp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前,不会返回控制。 7 D% `& }2 f& V8 q+ J' P. M! y
当授予用户执行权限时,用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。 7 {& \* J0 z8 M- d5 f
默认情况下,只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是,也可以授予其他用户执行此存储过程的权限。 7 z* Y. V; }8 n+ X+ }" x& G
当作为 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 用户的安全上下文下执行。
/ y8 Z, ?* v* M
" s8 ?9 l9 R$ @7 ?+ k/ E7 M说明 在早期版本中,获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server,以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中,该帐户称为 SQLAgentCmdExec。现在,不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令,而无需再进行配置更改。
, o& F" H9 _# n% a N+ N, ?9 w' r9 o2 _$ c
权限
$ C. Z# x; b* w" @8 L xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员,但可以授予其他用户。
. Z; ~% A q' C0 P& @8 r1 Y% ^! N + v; v3 f! v8 f! g/ Q. M
重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员,则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。0 _! \& R7 r% |! t, U) |* C
) R6 M+ {! o0 X1 W( C3 n8 g' W示例A. 返回可执行文件列表* [! q) ~2 X) r6 V; q/ X
下例显示执行目录命令的 xp_cmdshell 扩展存储过程。 EXEC master..xp_cmdshell 'dir *.exe'
, F; l: V6 `# i$ M! t9 vB. 使用 Windows NT net 命令 |; v9 m% V7 Q0 ]9 U2 w
下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭,然后用 net pause 暂停服务器,最后用 net stop 关闭服务器。 CREATE PROC shutdown10) Q T' S8 G4 [5 o
AS/ u- A3 H' S" E/ v/ J: j7 `2 @
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
4 G7 E L3 h& Q+ P, O9 P# ]3 q in 10 minutes. No more connections allowed.', no_output
: g4 ~3 q9 s! v% f" Q" {$ g' L2 uEXEC xp_cmdshell 'net pause sqlserver'9 Y1 q- k# Q$ b) Q: g0 u2 ?* [/ V
WAITFOR DELAY '00:05:00'
+ @! o* J# z% H! E% m0 hEXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down 0 Z+ N: W8 {. g( r7 \
in 5 minutes.', no_output" F9 p {2 |& m
WAITFOR DELAY '00:04:00'3 E! T8 N' A7 B. V2 {0 z/ |/ m
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down 5 k% \; u5 x5 o8 w4 F
in 1 minute. Log off now.', no_output
3 D8 F: N/ S+ X8 F! }WAITFOR DELAY '00:01:00'
/ E) y: K0 A( O/ _" t/ ZEXEC xp_cmdshell 'net stop sqlserver', no_output) x. Z: T" h1 e: u
C. 不返回输出 + A8 P! y# x; ~, {! M* c( b# B0 t
下例使用 xp_cmdshell 执行命令字符串,且不向客户端返回输出。 USE master" r7 K! f$ K }- C: P0 h
EXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
0 \5 i Z+ q7 a6 K* ?. b NO_OUTPUT" s( h5 M3 W7 m" @' P: ]
D. 使用返回状态( I; b6 w8 |6 Z+ _' { ?
在下例中,xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。 DECLARE @result int
, A. q7 l3 N" `9 D& B0 GEXEC @result = xp_cmdshell 'dir *.exe'& f) D5 F; ^: S; b
IF (@result = 0)3 y. x! ]$ ?, ^6 H& I3 m3 r
PRINT 'Success'4 }; U$ o; w0 G( _- q
ELSE2 u2 y2 g( d+ O# x2 x
PRINT 'Failure'
9 o1 ^; q2 g) m! q a( @- EE. 将变量内容写入文件
& S* {; G8 Z' r% L8 @下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname! D4 [ r+ C$ r5 r, v6 f
SET @var = 'Hello world'
4 I: Q+ G/ ? A* g. ySET @cmd = 'echo ' + @var + ' > var_out.txt'* k+ S$ x6 D+ x* x5 t
EXEC master..xp_cmdshell @cmd" I2 {$ J* m% J( u, v
F. 将命令的结果捕获到文件
# w+ F5 g3 w3 Q, t$ B$ `下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname4 e" e2 I! ~; A$ H6 o
SET @var = 'dir/p'! |3 m, K; [1 A. R3 Z! Q
SET @cmd = @var + ' > dir_out.txt'
. |/ v' s% T5 T* O( Q; S% ?EXEC master..xp_cmdshell @cmd
0 c" h) Y3 r; g1 v$ o9 w8 c$ p6 S. {$ w7 g
) }+ S/ D& V0 {- Z7 X
请参见. E# p5 p' C5 D4 w1 T
" n, ?1 {5 z$ U* x
sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE ( {% x8 Y( }. l3 [
sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE , G( B' Y7 H. C" Q" K# y
创建安全帐户
: n6 d! J8 v" }# Jsqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程(常规扩展过程)
% l. Q8 v$ _: c. R4 w' c7 r+ |! b9 b7 M4 L! z4 ?4 b- }! O6 q+ ?
% V% C n P7 U9 u' H6 t
|