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

Diese Funktion gibt einen INTEGER-Exit-Code zurück.

xp_cmdshell führt einen Systembefehl aus und gibt dann die Kontrolle an die aufrufende Umgebung zurück. Der von xp_cmdshell zurückgegebene Wert ist der Beendigungscode aus dem ausgeführten Shell-Prozess. Der Rückgabewert ist 2, wenn ein Fehler beim Start des untergeordneten Prozesses auftritt.

Der zweite Parameter betrifft nur Befehlszeilenanwendungen in Windows-Betriebssystemen. In UNIX wird ungeachtet der Einstellung für den zweiten Parameter kein Befehlsfenster angezeigt.

Für Windows Mobile sind alle ausgeführten Befehle ungeachtet der Einstellung des zweiten Parameters im Meldungslog des Datenbankservers ersichtlich. Die Konsolen-Shell \\windows\cmd.exe ist erforderlich, um die Prozedur auszuführen.

Sie müssen das SERVER OPERATOR-Systemprivileg haben.

• CALL-Anweisung
• Systemprozeduren für Verzeichnisse und Dateien
• Allgemeine Sicherheitstipps

Die folgende Anweisung listet die Dateien im aktuellen Verzeichnis in der Datei c:\temp.txt auf:

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

Die folgende Anweisung führt den gleichen Vorgang aus, allerdings ohne Anzeige eines Befehlsfensters.

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