xp_cmdshell (TransactSQL)

SQL Server 2008 R2

生成 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 选项。

重要提示

如果 xp_cmdshell 在批处理中执行并返回错误，则该批处理将失败。这是行为的更改。在 MicrosoftSQL 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)。

权限

---

因为恶意用户有时试图使用 xp_cmdshell 提升其特权，所以，默认情况下禁用 xp_cmdshell。使用 sp_configure 或基于策略的管理以启用它。有关详细信息，请参阅 xp_cmdshell 选项。

首次启用时，xp_cmdshell 要求 CONTROL SERVER 权限以执行进程，而 xp_cmdshell 创建的 Windows 进程与 SQL Server 服务帐户具有相同的安全上下文。SQL Server 服务帐户通常具有的权限要高于由 xp_cmdshell 创建的进程所执行的工作所需的权限。为了提高安全性，对于 xp_cmdshell 的访问应限制为具有高特权的用户。

若要允许非管理员使用 xp_cmdshell 并允许 SQL Server 使用较低特权帐户的安全标记创建子进程，请遵循以下步骤：

1. 使用进程要求的最小特权创建并自定义一个 Windows 本地用户帐户或一个域帐户。

2. 使用 sp_xp_cmdshell_proxy_account 系统过程配置 xp_cmdshell 以使用最小特权帐户。

   注意

   可以通过在对象资源管理器中右键单击服务器名称的属性，并在安全选项卡上查找服务器代理帐户部分，使用 SQL Server Management Studio 来配置此代理帐户。

3. 在 Management Studio 中，使用 master 数据库，执行 GRANT exec ON xp_cmdshell TO '<somelogin>' 语句以向特定的非 sysadmin 用户授予执行 xp_cmdshell 的能力。指定的登录名必须映射到 master 数据库中的用户。

现在，非管理员可以使用 xp_cmdshell 启动操作系统进程以及使用您已配置的代理帐户的权限运行的那些进程。对于由 xp_cmdshell 启动的子进程，具有 CONTROL SERVER 权限（sysadmin 固定服务器角色的成员）的用户将继续获得 SQL Server 服务帐户的权限。

为了确定在启动操作系统进程时 xp_cmdshell 正在使用的 Windows 帐户，应执行以下语句：

xp_cmdshell 'whoami.exe'

若要确定其他登录名的安全上下文，请执行以下语句：

EXECUTE AS LOGIN = '<other_login>' ;
GO
xp_cmdshell 'whoami.exe' ;
REVERT ; 

示例

---

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 选项

了解外围应用配置器