xp_cmdshel完全手册
<P>以操作系统命令行解释器的方式执行给定的命令字符串，并以文本行方式返回任何输出。授予非管理用户执行 <B>xp_cmdshell</B> 的权限。</P><P></P>
<B>说明</B> 在 Microsoft® Windows® 98 操作系统中执行 <B>xp_cmdshell </B>时，将不把 <B>xp_cmdshell </B>的返回代码设置为唤醒调用的可执行文件的进程退出代码。返回代码始终为 0。</P>
语法
<P><B>xp_cmdshell </B>{<B>'</B><I>command_string</I><B>'</B>} [<B>, no_output</B>]</P>
参数
<P><B>'</B><I>command_string</I><B>'</B></P>
<P>是在操作系统命令行解释器上执行的命令字符串。<I>command_string </I>的数据类型为 <B>varchar(8000)</B> 或 <B>nvarchar(4000)</B>，没有默认值。<I>command_string </I>不能包含一对以上的双引号。如果由 <I>command_string </I>引用的文件路径或程序名称中有空格，则需要使用一对引号。如果使用嵌入空格不方便，可考虑使用 FAT 8.3 文件名作为解决办法。</P>
<P><B>no_output</B></P>
<P>是可选参数，表示执行给定的 <I>command_string</I>，但不向客户端返回任何输出。</P>
返回代码值
<P>0（成功）或 1（失败）</P>
结果集
<P>执行下列 <B>xp_cmdshell </B>语句将返回当前目录的目录列表。</P>xp_cmdshell 'dir *.exe'
<P>行以 <B>nvarchar(255) </B>列的形式返回。</P>
<P>执行下列 <B>xp_cmdshell </B>语句将返回随后的结果集：</P>xp_cmdshell 'dir *.exe', NO_OUTPUT
<P>下面是结果：</P>The command(s) completed successfully.
注释
<P><B>xp_cmdshell</B> 以同步方式操作。在命令行解释器命令执行完毕之前，不会返回控制。</P>
<P>当授予用户执行权限时，用户能在 Microsoft Windows NT® 命令行解释器上执行运行 Microsoft SQL Server™ 的帐户有权执行的任何操作系统命令。</P>
<P>默认情况下，只有 <B>sysadmin</B> 固定服务器角色的成员才能执行此扩展存储过程。但是，也可以授予其他用户执行此存储过程的权限。 </P>
<P>当作为 <B>sysadmin</B> 固定服务器角色成员的用户唤醒调用 <B>xp_cmdshell </B>时，将在运行 SQL Server 服务的安全上下文中执行 <B>xp_cmdshell</B>。当用户不是 <B>sysadmin</B> 组的成员时，<B>xp_cmdshell</B> 将模拟使用 <B>xp_sqlagent_proxy_account </B>指定的 SQL Server 代理程序的代理帐户。如果代理帐户不能用，则 <B>xp_cmdshell</B> 将失败。这只是针对于 Microsoft® Windows NT® 4.0 和 Windows 2000。在 Windows 9.x 上，没有模拟，且 <B>xp_cmdshell</B> 始终在启动 SQL Server 的 Windows 9.x 用户的安全上下文下执行。</P>
<P></P>
<B>说明</B> 在早期版本中，获得 <B>xp_cmdshell</B> 执行权限的用户在 MSSQLServer 服务的用户帐户上下文中运行命令。可以通过配置选项配置 SQL Server，以便对 SQL Server 无 <B>sa </B>访问权限的用户能够在 <B>SQLExecutiveCmdExec</B> Windows NT 帐户的上下文中运行 <B>xp_cmdshell</B>。在 SQL Server 7.0 中，该帐户称为 <B>SQLAgentCmdExec</B>。现在，不是 <B>sysadmin</B> 固定服务器角色成员的用户将在该帐户上下文中运行命令，而无需再进行配置更改。</P>
<p>
权限
<P><B>xp_deletemail </B>的执行权限默认授予 <B>sysadmin</B> 固定服务器角色的成员，但可以授予其他用户。 </P>
<P></P>
<B>重要</B> 如果为 MSSQLServer 服务选用的 Windows NT 帐户不是本地管理员组的成员，则非 <B>sysadmin</B> 固定服务器角色成员的用户将无法执行 <B>xp_cmdshell</B>。</P>
<p>
示例A. 返回可执行文件列表
<P>下例显示执行目录命令的 <B>xp_cmdshell </B>扩展存储过程。</P>EXEC master..xp_cmdshell 'dir *.exe'
B. 使用 Windows NT net 命令
<P>下例显示 <B>xp_cmdshell </B>在存储过程中的使用。下例先用 <B>net send </B>通知用户 SQL Server 即将关闭，然后用 <B>net pause </B>暂停服务器，最后用 <B>net stop </B>关闭服务器。</P>CREATE PROC shutdown10
AS
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
in 10 minutes. No more connections allowed.', no_output
EXEC xp_cmdshell 'net pause sqlserver'
WAITFOR DELAY '00:05:00'
EXEC xp_cmdshell 'net send /domain: SQL_USERS ''SQL Server shutting down
in 5 minutes.', no_output
WAITFOR DELAY '00:04:00'
EXEC xp_cmdshell 'net send /domain:SQL_USERS ''SQL Server shutting down
in 1 minute. Log off now.', no_output
WAITFOR DELAY '00:01:00'
EXEC xp_cmdshell 'net stop sqlserver', no_output
C. 不返回输出
<P>下例使用 <B>xp_cmdshell</B> 执行命令字符串，且不向客户端返回输出。</P>USE master
EXEC xp_cmdshell 'copy c:\sqldumps\pubs.dmp \\server2\backups\sqldumps',
NO_OUTPUT
D. 使用返回状态
<P>在下例中，<B>xp_cmdshell</B> 扩展存储过程也给出了返回状态。返回代码值存储在变量 <B>@result</B> 中。</P>DECLARE @result int
EXEC @result = xp_cmdshell 'dir *.exe'
IF (@result = 0)
PRINT 'Success'
ELSE
PRINT 'Failure'
E. 将变量内容写入文件
<P>下例将 @var 变量的内容写入当前服务器目录下名为 var_out.txt 的文件中。</P>DECLARE @cmd sysname, @var sysname
SET @var = 'Hello world'
SET @cmd = 'echo ' + @var + ' > var_out.txt'
EXEC master..xp_cmdshell @cmd
F. 将命令的结果捕获到文件
<P>下例将当前目录的内容写入当前服务器目录中名为 dir_out.txt 的文件中。</P>DECLARE @cmd sysname, @var sysname
SET @var = 'dir/p'
SET @cmd = @var + ' > dir_out.txt'
EXEC master..xp_cmdshell @cmd
<P>
<B>请参见</B>
<p>
<P>sqlserver2000/tsqlref/ts_create_4hk5.htm">CREATE PROCEDURE</P>
<P>sqlserver2000/tsqlref/ts_ea-ez_05ro.htm">EXECUTE</P>
<P>创建安全帐户</P>
<P>sqlserver2000/tsqlref/ts_sp_00_519s.htm">系统存储过程（常规扩展过程）</P>
<P>
<p>
页:
[1]