xp_cmdshel完全手册

韩冰

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

5 [# {0 s k' A: f" z% ^说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时，将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。

' l, j3 }' S' c$ {: J$ I& P* S . J6 N$ r% j' k% Z. j+ Q语法 : m1 n, u& y+ C' I

xp_cmdshell {'command_string'} [, no_output]

参数

'command_string'

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

+ p9 w* `4 @+ o) H6 q; ]* x& }

no_output

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

返回代码值

0（成功）或 1（失败）

/ ~1 N5 f8 ~$ X/ N# t6 e+ A结果集 / ^) b8 y/ M/ d) }

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

xp_cmdshell 'dir *.exe' 9 w; n. L' C) K3 V; X

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

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

xp_cmdshell 'dir *.exe', NO_OUTPUT 0 u/ b$ `' |$ D# n ; b' P& J! H2 f* G8 ^3 ^& Q( j

下面是结果：

The command(s) completed successfully. 注释

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

2 a8 H/ q0 q" ? t' L1 I0 e

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

% P1 \( {1 y" O% M

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

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

$ o* v4 ~- n- H* D! [6 r* o$ e9 }8 d* \

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

0 A1 ?+ Y3 T$ V% c% b Y4 m权限

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

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

, q- w% T: w! N, a* v$ }示例A. 返回可执行文件列表 & N. {' v& j1 \5 E

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

EXEC master..xp_cmdshell 'dir *.exe' B. 使用 Windows NT net 命令 ! A/ k1 p2 G& _

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

CREATE PROC shutdown10 AS % B0 C2 u. O" V8 \# R4 MEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down in 10 minutes. No more connections allowed.', no_output ) H' s. e* s2 N, o$ U% x5 HEXEC xp_cmdshell 'net pause sqlserver' WAITFOR DELAY '00:05:00' 7 T: l; i" K" Z1 DEXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down 1 z3 N: [( n$ m! M9 C" `# t4 @ in 5 minutes.', no_output # a7 P( [' a4 nWAITFOR DELAY '00:04:00' $ W3 j- Y6 K- f/ M) ZEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down 6 t. C: |% Q) T2 v( h! f) a in 1 minute. Log off now.', no_output 8 ?2 N- e6 m! d9 @* F8 ~' IWAITFOR DELAY '00:01:00' 5 b7 { T; m6 A1 ^' F+ N* p. YEXEC xp_cmdshell 'net stop sqlserver', no_output 2 j( D8 ~. N1 y: P" OC. 不返回输出 ' t3 ]+ ~8 G1 m7 _/ s" t3 F4 T3 j& C

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

USE master EXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps', & B5 u9 \5 Z; E0 c NO_OUTPUT D. 使用返回状态 3 b, ]% ~7 U' f+ W

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

DECLARE @result int 6 G$ y+ W9 ]) q5 WEXEC @result = xp_cmdshell 'dir *.exe' ( k4 F$ `& i5 J5 ?! u# {- v, [IF (@result = 0) ( u0 r% U" f, O PRINT 'Success' , O' p L2 ?3 |" H. iELSE : A; s0 i# N* T9 u* D PRINT 'Failure' E. 将变量内容写入文件

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

DECLARE @cmd sysname, @var sysname SET @var = 'Hello world' SET @cmd = 'echo ' + @var + ' > var_out.txt' % i1 M# @; q! Y" z7 l# O: KEXEC master..xp_cmdshell @cmd F. 将命令的结果捕获到文件

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

DECLARE @cmd sysname, @var sysname ; Q2 b" q' m9 E# A$ ]SET @var = 'dir/p' SET @cmd = @var + ' > dir_out.txt' ' Z" Q. q R7 [4 U' }. D HEXEC master..xp_cmdshell @cmd

请参见 # e8 b4 F' ~/ l. \4 {. A

' @; H, p$ ^2 C6 D9 {" w7 }

sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE

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

7 x6 `7 g9 f$ `" z$ x

创建安全帐户

0 R. O" ~2 c4 G

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

8 z# k/ z, b4 R- ]- K* B/ l