Invoke-Sqlcmd-Cmdlet

Invoke-Sqlcmd ist ein SQL Server Cmdlet, das Skripts ausführt, die Anweisungen aus den Sprachen (Transact-SQL und XQuery) und Befehle enthalten, die vom sqlcmd-Hilfsprogramm unterstützt werden.

Verwenden von Invoke-Sqlcmd

Mit dem Invoke-Sqlcmd -Cmdlet können Sie die sqlcmd -Skriptdateien in einer Windows PowerShell-Umgebung ausführen. Viele der Vorgänge, die Sie mit sqlcmd durchführen können, können auch mit Invoke-Sqlcmddurchgeführt werden.

Dies ist ein Beispiel für den Aufruf von Invoke-Sqlcmd zum Ausführen einer einfachen Abfrage, die dem Festlegen von sqlcmd mit den Optionen -Q und -S ähnelt:

Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MyInstance"  

Dies ist ein Beispiel für den Aufruf von Invoke-Sqlcmd, in dem eine Eingabedatei angegeben und die Ausgabe an eine Datei weitergeleitet wird. Dies ähnelt dem Festlegen von sqlcmd mit den Optionen -i und -o :

Invoke-Sqlcmd -InputFile "C:\MyFolder\TestSQLCmd.sql" | Out-File -FilePath "C:\MyFolder\TestSQLCmd.rpt"  

Dies ist ein Beispiel für die Verwendung eines Windows PowerShell-Arrays zum Übergeben von mehreren sqlcmd -Skriptvariablen an Invoke-Sqlcmd. Die „$“-Zeichen, die die sqlcmd -Skriptvariablen in der SELECT-Anweisung identifizieren, wurden mit dem PowerShell-Escapezeichen „`“ versehen:

$MyArray = "MyVar1 = 'String1'", "MyVar2 = 'String2'"  
Invoke-Sqlcmd -Query "SELECT `$(MyVar1) AS Var1, `$(MyVar2) AS Var2;" -Variable $MyArray  

Dies ist ein Beispiel für die Verwendung des SQL Server-Anbieters für Windows PowerShell, um zu einer instance der Datenbank-Engine zu navigieren, und dann das Cmdlet Windows PowerShell Get-Item zum Abrufen des SMO-Serverobjekts für die instance und zum Übergeben an Invoke-Sqlcmd:

Set-Location SQLSERVER:\SQL\MyComputer\MyInstance  
Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance (Get-Item .)  

Der Query-Parameter ist ein Positionsparameter und muss nicht benannt werden. Wenn die erste Zeichenfolge, die an Invoke-Sqlcmdübergeben wird, nicht benannt ist, wird dieser als Parameter „-Query“ behandelt.

Invoke-Sqlcmd "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MyInstance"  

Pfadkontext in Invoke-Sqlcmd

Wenn Sie den Database-Parameter nicht verwenden, wird der Datenbankkontext für Invoke-Sqlcmd vom Pfad gesetzt, der aktiv ist, wenn cmdlet aufgerufen wird.

Nehmen wir beispielsweise an, dass die Standarddatenbank für Ihr Windows-Konto in der Standardinstanz auf dem lokalen Computer die master-Datenbank ist. Dann würden die folgenden Befehle master zurückgeben:

Set-Location SQLSERVER:\SQL  
Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"  

Die folgenden Befehle geben AdventureWorks2012 zurück:

Set-Location SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2012\Tables\Person.Person  
Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"  

Invoke-Sqlcmd stellt eine Warnung bereit, wenn es den Pfaddatenbankkontext verwendet. Sie können den SuppressProviderContextWarning-Parameter verwenden, um die Warnmeldung zu deaktivieren. Sie können den IgnoreProviderContext-Parameter verwenden, um Invoke-Sqlcmd anzuweisen, immer die Standarddatenbank für die Anmeldung zu verwenden.

Vergleichen von Invoke-Sqlcmd und dem sqlcmd-Hilfsprogramm

MitInvoke-Sqlcmd können zahlreiche der Skripts ausgeführt werden, die auch mit dem sqlcmd Hilfsprogramm ausgeführt werden können. Invoke-Sqlcmd wird jedoch in einer Windows PowerShell-Umgebung ausgeführt, die sich von der Eingabeaufforderungsumgebung unterscheidet, in der sqlcmd ausgeführt wird. Das Verhalten von Invoke-Sqlcmd wurde für die Ausführung in einer Windows PowerShell-Umgebung angepasst.

Nicht alle sqlcmd -Befehle sind in Invoke-Sqlcmdimplementiert. Befehle, die nicht implementiert werden, sind die folgenden: :!!, :connect, :error, :out, :ed, :list, :listvar, :reset, :perftrace, and :serverlist.

Invoke-Sqlcmd initialisiert die sqlcmd -Umgebung oder Skriptvariablen wie SQLCMDDBNAME oder SQLCMDWORKSTATION nicht.

Invoke-Sqlcmd zeigt keine Meldungen, wie die Ausgabe von PRINT-Anweisungen, an, außer Sie geben den gängigen Windows PowerShell-Parameter -Verbose an. Beispiel:

Invoke-Sqlcmd -Query "PRINT N'abc';" -Verbose  

Nicht alle sqlcmd -Parameter werden in einer PowerShell-Umgebung benötigt. Beispielsweise formatiert Windows PowerShell alle Ausgaben von Cmdlets, sodass die sqlcmd -Parameter, die Formatierungsoptionen festlegen, nicht in Invoke-Sqlcmdimplementiert werden. Die folgende Tabelle zeigt die Beziehung zwischen den Parametern Invoke-Sqlcmd und sqlcmd :

Weitere Informationen

Verwenden der Datenbank-Engine-Cmdlets
SQLCMD-Hilfsprogramm
Verwenden des Hilfsprogramms sqlcmd