|
以操作系统命令行解释器的方式执行给定的命令字符串,并以文本行方式返回任何输出。授予非管理用户执行 xp_cmdshell 的权限。
' U& N4 B) s) t7 |2 I) N! R4 u ) |. D F( m, S$ S
说明 在 Microsoft® Windows® 98 操作系统中执行 xp_cmdshell 时,将不把 xp_cmdshell 的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。
# G: {% |, e A% q0 i0 }" M8 {$ Y6 o' h5 P5 C
, l" _9 p+ X* [% b1 X7 k9 u) L
语法
9 o# a6 z7 N' k1 P# t5 t7 R B) gxp_cmdshell {'command_string'} [, no_output] . k, a+ u7 L% o* I, y/ m; }
参数
' I" K1 n8 Q7 S4 U6 M% P) a'command_string' 2 y5 }8 d% x6 h+ F7 N
是在操作系统命令行解释器上执行的命令字符串。command_string 的数据类型为 varchar(8000) 或 nvarchar(4000),没有默认值。command_string 不能包含一对以上的双引号。如果由 command_string 引用的文件路径或程序名称中有空格,则需要使用一对引号。如果使用嵌入空格不方便,可考虑使用 FAT 8.3 文件名作为解决办法。
' m5 B) W# w* {no_output ; V+ u3 L6 y3 H: c
是可选参数,表示执行给定的 command_string,但不向客户端返回任何输出。 # A! O8 b- r& A( U
返回代码值) O( T0 w6 N/ p) }/ d" i) Q
0(成功)或 1(失败)
7 q8 Y( d# A7 h9 N结果集" z e4 R( J9 P& m; x$ y* K9 A
执行下列 xp_cmdshell 语句将返回当前目录的目录列表。 xp_cmdshell 'dir *.exe'
; w2 h5 G# e* V5 q) ^! |7 d' s" O! I
行以 nvarchar(255) 列的形式返回。
# G4 i) X( e1 e$ D5 }执行下列 xp_cmdshell 语句将返回随后的结果集: xp_cmdshell 'dir *.exe', NO_OUTPUT
$ v! L% n% F5 c( w4 _6 p
. e" I( Y0 G7 ?5 N下面是结果: The command(s) completed successfully.
. [4 @* e& Z0 e: l& c. R4 {# f注释0 k# T2 Y- i5 x3 m) Y
xp_cmdshell 以同步方式操作。在命令行解释器命令执行完毕之前,不会返回控制。 9 L4 }* ^9 q7 F
当授予用户执行权限时,用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。
! X# J+ Z) U# I9 Q$ _( n4 z R默认情况下,只有 sysadmin 固定服务器角色的成员才能执行此扩展存储过程。但是,也可以授予其他用户执行此存储过程的权限。 ; e% S. Z3 @, c7 S( R9 D
当作为 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 用户的安全上下文下执行。 # `0 S( c; l! ], s$ k1 `* p
7 `: W% ]# K2 e$ ~1 |% Y0 ]
说明 在早期版本中,获得 xp_cmdshell 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server,以便对 SQL Server 无 sa 访问权限的用户能够在 SQLExecutiveCmdExec Windows NT 帐户的上下文中运行 xp_cmdshell。在 SQL Server 7.0 中,该帐户称为 SQLAgentCmdExec。现在,不是 sysadmin 固定服务器角色成员的用户将在该帐户上下文中运行命令,而无需再进行配置更改。 u" H6 V# V0 I. c0 L' w' C* b
; J! m# S& @- G8 Y, Q权限
8 Q& Q3 t# y l. Y) ]9 f4 D xp_deletemail 的执行权限默认授予 sysadmin 固定服务器角色的成员,但可以授予其他用户。
& K7 b, L' a% J2 p! |
3 }/ s: b' N* }" {/ g9 J$ r0 z重要 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员,则非 sysadmin 固定服务器角色成员的用户将无法执行 xp_cmdshell。
: X# H% |" Q8 \8 h7 p% J$ ?4 E. J ^, x% ^/ d
示例A. 返回可执行文件列表
- m* C$ V7 x' e# T1 Z7 T3 | 下例显示执行目录命令的 xp_cmdshell 扩展存储过程。 EXEC master..xp_cmdshell 'dir *.exe'
% P6 y& E+ q/ i6 o: sB. 使用 Windows NT net 命令
4 h3 W- Q) K; b7 v- O) L下例显示 xp_cmdshell 在存储过程中的使用。下例先用 net send 通知用户 SQL Server 即将关闭,然后用 net pause 暂停服务器,最后用 net stop 关闭服务器。 CREATE PROC shutdown10
# u! A" l" x' C9 v: \( yAS
/ l3 K* N0 p" C/ j' \/ D$ D( bEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down 1 w1 S' t' n# D! ^
in 10 minutes. No more connections allowed.', no_output
9 N7 z7 T3 r, M1 e, Q" EEXEC xp_cmdshell 'net pause sqlserver'# K1 C1 d. [3 L* C, f+ H
WAITFOR DELAY '00:05:00'4 O# ^$ P$ w- j6 n; f* G
EXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down & X8 x3 b1 Y8 l% f L
in 5 minutes.', no_output
+ M* s, [6 i3 ?, R2 fWAITFOR DELAY '00:04:00'
Z" @- q& L1 y# h, K" R" V9 pEXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down 9 Y% t5 g( e, }. }
in 1 minute. Log off now.', no_output0 a% W' l4 u: x2 c& L9 H6 v
WAITFOR DELAY '00:01:00'9 x2 j7 Y m* r
EXEC xp_cmdshell 'net stop sqlserver', no_output
3 w1 M/ M* w* B$ ^: j+ TC. 不返回输出 / s* f1 _; Z. ]* T" R8 f) ~$ J
下例使用 xp_cmdshell 执行命令字符串,且不向客户端返回输出。 USE master
# X5 x# [% {, {( c. O% iEXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
! ]" i8 ]0 I$ z' w2 h! E NO_OUTPUT8 q1 r7 y# q5 ~+ f1 }! g
D. 使用返回状态" J0 y" {- F( ~/ v0 r' y _7 P
在下例中,xp_cmdshell 扩展存储过程也给出了返回状态。返回代码值存储在变量 @result 中。 DECLARE @result int
% V5 n, {( R+ }" SEXEC @result = xp_cmdshell 'dir *.exe'
) S+ @& h/ Z4 m6 a0 }; oIF (@result = 0)* m# l( M( c% {6 N# _8 A
PRINT 'Success'
( v4 z; A8 C0 |; G8 L, {ELSE
4 F. c8 Y# r( K! c PRINT 'Failure'
2 n# {9 _+ b% H* XE. 将变量内容写入文件
: s1 _) p- F1 i2 z下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname9 f8 A# D3 \' \* P" G8 v2 Z
SET @var = 'Hello world'" |6 m6 N& Y' {& ^" ^6 S
SET @cmd = 'echo ' + @var + ' > var_out.txt'
$ }- z- D6 n* s! @EXEC master..xp_cmdshell @cmd: l, S; ]% J5 C4 p, ^4 t2 ~5 r5 T6 z
F. 将命令的结果捕获到文件0 k) I+ j. O4 Q7 z) `
下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。 DECLARE @cmd sysname, @var sysname
- R C" Q& |0 y0 _! }SET @var = 'dir/p'+ A$ u7 r& Z3 ?8 Q
SET @cmd = @var + ' > dir_out.txt'
5 [4 b8 s8 S9 xEXEC master..xp_cmdshell @cmd
% G( ^2 I4 J! E2 p% {2 ` }
3 k4 g- k/ P5 o/ D- ]+ r- q: ~; b: H/ q a! I; a
请参见$ D" o Y- e; U) m7 E9 ^
]# Z5 v! _* b. D6 {
sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE
& D4 x" D; Y4 n8 g4 s; w1 {sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE
- r4 s8 r+ V& e9 C- |; I创建安全帐户 2 Y+ U% S% L2 o
sqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程(常规扩展过程) - D9 M" R+ L. i3 ]
5 Z* o9 O9 G4 k9 j3 O' \
& i5 }& S4 q! K8 n( N5 q |