[アーティクル]
09/28/2010

xp_cmdshell (Transact-SQL)

Windows のコマンドシェルを起動し、実行用の文字列を渡します。出力は、テキストの行として返されます。

構文

xp_cmdshell { 'command_string' } [ , no_output ]

引数

'command_string'
オペレーティングシステムに渡すコマンドを含む文字列を指定します。command_string のデータ型は varchar(8000) または nvarchar(4000) で、既定値はありません。command_string に、二重引用符を 2 組以上含めることはできません。command_string で参照するファイルパスまたはプログラム名にスペースがある場合は、引用符を 1 組指定する必要があります。ファイルパスやファイル名に埋め込まれたスペースに関する問題が発生する場合は、その問題への対処方法として 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 は、同期して動作します。制御は、コマンドシェルのコマンドが完了するまで呼び出し元に返されません。

ポリシーベースの管理を使用するか、sp_configure を実行すると、xp_cmdshell を有効または無効にできます。詳細については、「セキュリティ構成について」および「xp_cmdshell オプション」を参照してください。

重要
xp_cmdshell をバッチ内で実行し、エラーが返された場合、バッチは失敗します。これは新しい動作です。以前のバージョンの MicrosoftSQL Server では、バッチは続行されていました。

xp_cmdshell プロキシアカウント

sysadmin 固定サーバーロールのメンバー以外のユーザーが xp_cmdshell を呼び出した場合は、##xp_cmdshell_proxy_account## という資格情報に格納されているアカウント名とパスワードによって、Windows への接続が行われます。このプロキシ資格情報が存在しない場合、xp_cmdshell は失敗します。

プロキシアカウントの資格情報は、sp_xp_cmdshell_proxy_account を実行して作成できます。このストアドプロシージャは、Windows のユーザー名とパスワードを引数にとります。たとえば次のコマンドでは、Windows ドメインユーザー SHIPPING\KobeR 用のプロキシ資格情報が、Windows パスワード sdfh%dkc93vcMt0 で作成されます。

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 で特権レベルの低いアカウントのセキュリティトークンを使用して子プロセスを作成できるようにするには、次の手順を実行します。

プロセスに必要な最低限の特権を持つ Windows ローカルユーザーアカウントまたはドメインアカウントを作成およびカスタマイズします。

sp_xp_cmdshell_proxy_account システムプロシージャを使用して、その最小特権アカウントを使用するように xp_cmdshell を構成します。

注意
このプロキシアカウントは、SQL Server Management Studio を使用して構成することもできます。そのためには、オブジェクトエクスプローラーでサーバー名を右クリックして [プロパティ] をクリックし、[セキュリティ] タブの [サーバーのプロキシアカウント] セクションを使用します。

Management Studio で、master データベースを使用して GRANT exec ON xp_cmdshell TO '<somelogin>' ステートメントを実行し、xp_cmdshell を実行する権限を sysadmin 以外の特定のユーザーに与えます。指定したログインが master データベース内のユーザーにマップされている必要があります。

これで、管理者以外のユーザーが xp_cmdshell を使用してオペレーティングシステムのプロセスを起動できるようになりました。起動されたプロセスは、構成したプロキシアカウントの権限を使用して実行されます。CONTROL SERVER 権限を持つユーザー (sysadmin 固定サーバーロールのメンバー) には、引き続き、xp_cmdshell によって起動された子プロセスで 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

変更履歴

変更内容
権限に関するセクションの内容を改善しました。

次の方法で共有

xp_cmdshell (Transact-SQL)

構文

引数

リターンコード値

結果セット

説明

xp_cmdshell プロキシアカウント

権限

例

A. 実行可能ファイルの一覧を返す

B. Windows の net コマンドを使用する

C. 出力を返さない

D. 戻りステータスを使用する

E. さまざまな内容をファイルに書き込む

F. コマンドの結果をファイルにキャプチャする

変更履歴

関連項目

参照

概念

その他のリソース

次の方法で共有

xp_cmdshell (Transact-SQL)

構文

引数

リターン コード値

結果セット

説明

xp_cmdshell プロキシ アカウント

権限

例

A. 実行可能ファイルの一覧を返す

B. Windows の net コマンドを使用する

C. 出力を返さない

D. 戻りステータスを使用する

E. さまざまな内容をファイルに書き込む

F. コマンドの結果をファイルにキャプチャする

変更履歴

関連項目

参照

概念

その他のリソース

リターンコード値

xp_cmdshell プロキシアカウント