xp_cmdshell (Transact-SQL)

生成 Windows 命令 shell 并以字符串的形式传递以便执行。任何输出都作为文本的行返回。

主题链接图标Transact-SQL 语法约定

语法

xp_cmdshell { 'command_string' } [ , no_output ]

参数

  • 'command_string'
    包含要传递到操作系统的命令的字符串。command_string 的数据类型为 varchar(8000)nvarchar(4000),无默认值。command_string 不能包含一对以上的双引号。如果 command_string 中引用的文件路径或程序名中存在空格,则需要使用一对引号。如果不方便使用内含的空格,则可考虑使用 FAT 8.3 文件名作为解决方法。
  • no_output
    可选参数,指定不应向客户端返回任何输出。

返回代码值

0(成功)或 1(失败)

结果集

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

EXEC xp_cmdshell 'dir *.exe';
GO

行以 nvarchar(255) 列的形式返回。如果使用 no_output 选项,则仅返回以下内容:

The command(s) completed successfully.

备注

xp_cmdshell 生成的 Windows 进程与 SQL Server 服务帐户具有相同的安全权限。

xp_cmdshell 以同步方式操作。在命令 shell 命令执行完毕之前,不会将控制权返回给调用方。

可以使用外围应用配置器工具以及通过执行 sp_configure 来启用和禁用 xp_cmdshell。有关详细信息,请参阅外围应用配置xp_cmdshell 选项

ms175046.note(zh-cn,SQL.90).gif重要提示:
如果 xp_cmdshell 在批处理中执行并返回错误,则该批处理将失败。这是行为的更改。在 Microsoft SQL Server 的早期版本中,批处理将会继续执行。

xp_cmdshell 代理帐户

当不属于 sysadmin 固定服务器角色成员的用户调用 xp_cmdshell 时,xp_cmdshell 会使用名为 ##xp_cmdshell_proxy_account## 的凭据中存储的帐户名和密码连接到 Windows。如果该代理凭据不存在,则 xp_cmdshell 将失败。

代理帐户凭据可以通过执行 sp_xp_cmdshell_proxy_account 来创建。此存储过程将 Windows 用户名和密码作为参数使用。例如,以下命令为具有 Windows 密码 sdfh%dkc93vcMt0 的 Windows 域用户 SHIPPING\KobeR 创建代理凭据。

EXEC sp_xp_cmdshell_proxy_account 'SHIPPING\KobeR','sdfh%dkc93vcMt0'

有关详细信息,请参阅 sp_xp_cmdshell_proxy_account (Transact-SQL)

权限

需要 CONTROL SERVER 权限。

示例

A. 返回可执行文件列表

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

EXEC master..xp_cmdshell 'dir *.exe'

B. 使用 Windows net 命令

以下示例显示 xp_cmdshell 在存储过程中的使用。本例使用 net send 通知用户将要关闭 SQL Server 实例,使用 net pause 暂停服务器,然后使用 net stop 关闭服务器。

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. 不返回任何输出

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

USE master;
EXEC xp_cmdshell 'copy c:\SQLbcks\AdvWorks.bck
    \\server2\backups\SQLbcks, NO_OUTPUT';
GO

D. 使用返回状态

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

DECLARE @result int
EXEC @result = xp_cmdshell 'dir *.exe'
IF (@result = 0)
   PRINT 'Success'
ELSE
   PRINT 'Failure'

E. 将变量内容写入文件中

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

DECLARE @cmd sysname, @var sysname
SET @var = 'Hello world'
SET @cmd = 'echo ' + @var + ' > var_out.txt'
EXEC master..xp_cmdshell @cmd

F. 将命令的结果捕获到文件中

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

DECLARE @cmd sysname, @var sysname
SET @var = 'dir/p'
SET @cmd = @var + ' > dir_out.txt'
EXEC master..xp_cmdshell @cmd

请参阅

参考

常规扩展存储过程 (Transact-SQL)
sp_xp_cmdshell_proxy_account (Transact-SQL)

其他资源

xp_cmdshell 选项
外围应用配置

帮助和信息

获取 SQL Server 2005 帮助