xp_cmdshel完全手册

韩冰

以操作系统命令行解释器的方式执行给定的命令字符串，并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。

1 q5 L6 i6 R" f5 N2 @/ g9 [说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时，将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。

! q+ ]9 t3 u! l语法 0 Q: q( H6 {2 {6 H$ j5 o

xp_cmdshell {'command_string'} [, no_output]

参数 6 E% }: \7 R4 r& x( q

'command_string'

1 ^' `- g* X7 [0 k% k. a

是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000)，没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格，则需要使用一对引号。如果使用嵌入空格不方便，可考虑使用 FAT 8.3 文件名作为解决办法。

) [( n: ]' i) S6 M! J9 y" Q' Z# \- m

no_output

, v P3 y: G! o

是可选参数，表示执行给定的 command_string，但不向客户端返回任何输出。

返回代码值 6 _* |7 J2 |( ^; N9 m/ N

0（成功）或 1（失败）

结果集 8 s0 c8 [( N$ [- W

执行下列 xp_cmdshell 语句将返回当前目录的目录列表。

xp_cmdshell 'dir *.exe' 1 n) L4 {3 J9 h0 g6 m& ^

行以 nvarchar(255) 列的形式返回。

执行下列 xp_cmdshell 语句将返回随后的结果集：

xp_cmdshell 'dir *.exe', NO_OUTPUT ) t7 S# D8 X6 ?8 c. |, g 6 L" A; ] Z! j! U8 S

下面是结果：

The command(s) completed successfully. 注释

xp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前，不会返回控制。

. v6 o+ e5 q7 l# e% z

当授予用户执行权限时，用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。

默认情况下，只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是，也可以授予其他用户执行此存储过程的权限。

: Z3 _2 z1 X' t3 c

当作为 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 用户的安全上下文下执行。

* V; q2 Q( K$ q4 \, ~# w

说明 在早期版本中，获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server，以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中，该帐户称为 SQLAgentCmdExec。现在，不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令，而无需再进行配置更改。

1 C# V$ X Y0 k权限

xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员，但可以授予其他用户。

1 G1 U' D L. w8 B1 P& x

重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员，则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。

示例A. 返回可执行文件列表

下例显示执行目录命令的 xp_cmdshell 扩展存储过程。

EXEC master..xp_cmdshell 'dir *.exe' B. 使用 Windows NT net 命令 + N5 N3 _. S) { E

下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭，然后用 net pause 暂停服务器，最后用 net stop 关闭服务器。

CREATE PROC shutdown10 ; }8 `" k& p5 N- q# o9 ]2 }AS - ]9 S7 _1 o, z& ^5 ^6 b; \! ZEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down in 10 minutes. No more connections allowed.', no_output $ p+ ?! ~; [3 u1 ^9 P( X- o$ m% @" `* ]EXEC xp_cmdshell 'net pause sqlserver' WAITFOR DELAY '00:05:00' EXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down 3 b* u& N6 r. y% }5 R/ y in 5 minutes.', no_output WAITFOR DELAY '00:04:00' 8 ], }; C4 @" @! S5 BEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down 5 f" W; R/ a }, ?& [ in 1 minute. Log off now.', no_output WAITFOR DELAY '00:01:00' + u( @( R5 A* m0 L* GEXEC xp_cmdshell 'net stop sqlserver', no_output C. 不返回输出 ( K/ V) v5 t9 J( r, \9 h2 ?( G

下例使用 xp_cmdshell 执行命令字符串，且不向客户端返回输出。

USE master / D1 F6 Z- F9 m M2 `5 f- K1 K- VEXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps', & C0 f- D0 }2 [+ _* ?" a0 S+ t NO_OUTPUT 5 l" n' L% B, K' C7 q/ OD. 使用返回状态

在下例中，xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。

DECLARE @result int 4 _9 z- {0 S8 r `" xEXEC @result = xp_cmdshell 'dir *.exe' - c( t" Z' D# o: G2 S' LIF (@result = 0) o' r5 E( x* l3 H3 p; A9 Z% ^2 V PRINT 'Success' 2 R6 h8 ], C, D7 r F9 N. ^ELSE PRINT 'Failure' E. 将变量内容写入文件 5 r- m& R: |+ g% g2 K

下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。

DECLARE @cmd sysname, @var sysname ! C1 B, D# A* U& l& ^ t/ ^SET @var = 'Hello world' 2 Z! r. F. L! l, ^9 qSET @cmd = 'echo ' + @var + ' > var_out.txt' EXEC master..xp_cmdshell @cmd 6 X- M: [/ ^" _2 XF. 将命令的结果捕获到文件 , O; y/ ^# i2 B0 T

下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。

DECLARE @cmd sysname, @var sysname SET @var = 'dir/p' & R, q: u* T/ ^' D; \SET @cmd = @var + ' > dir_out.txt' EXEC master..xp_cmdshell @cmd 4 x. K! G# C# a4 R' b9 i7 ]" G ' ^1 ]1 x w8 c- y# k) H8 c; `4 o

请参见

4 h* \! ]; L% f; P) \

sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE

sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE

7 A* C+ Q/ r. f" O. B

创建安全帐户

sqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程（常规扩展过程）

$ o# ?% ?2 G6 e$ B, Q