xp_cmdshell( 
command 
[, redir_output  | 'no_output' ]
)

この関数は INTEGER 終了コードを返します。

xp_cmdshell は、システムコマンドを実行して、制御を元の環境に戻します。xp_cmdshell が返す値は、実行されたシェルプロセスからの終了コードです。子プロセスが起動したときにエラーが発生した場合、戻り値は 2 です。

2 番目のパラメータは、Windows オペレーティングシステムのコマンドラインアプリケーションにのみ影響します。UNIX の場合は、2 番目のパラメータの設定にかかわらず、コマンドウィンドウは表示されません。

Windows Mobile の場合は、2 番目のパラメータの設定にかかわらず、実行したすべてのコマンドがデータベースサーバメッセージログに表示されます。プロシージャを実行するには、コンソールシェル \\windows\cmd.exe が必要です。

SERVER OPERATOR システム権限が必要です。

• CALL 文
• ディレクトリとファイルのシステムプロシージャ
• セキュリティに関する一般的なヒント

次の文は、現在のディレクトリにあるファイルをファイル c:\temp.txt 内にリストします。

CALL xp_cmdshell( 'dir > c:\\temp.txt' );

次の文は、同じ処理を実行しますが、[コマンド] ウィンドウは表示されません。

CALL xp_cmdshell( 'dir > c:\\temp.txt', 'no_output' );