Verwenden des Invoke-Sqlcmd-Cmdlets

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-Sqlcmd durchgefü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 der -i-Option und der -o-Option:

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 zur Navigation zu einer Instanz von Database Engine (Datenbankmodul) und zur anschließenden Verwendung des Windows PowerShell-Cmdlets Get-Item, um das SMO-Serverobjekt für die Instanz abzurufen und es an Invoke-Sqlcmd zu übergeben:

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 Query-Parameter 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 würden AdventureWorks2008R2 zurückgeben:

Set-Location SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2008R2\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

Mit Invoke-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, in der sqlcmd ausgeführt wird, unterscheidet. Das Verhalten von Invoke-Sqlcmd wurde so geändert, dass es in einer Windows PowerShell-Umgebung funktioniert.

Nicht alle sqlcmd-Befehle sind in Invoke-Sqlcmd implementiert. Zu den nicht implementierten Befehlen gehören: :!!, :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-Sqlcmd implementiert werden. In der folgenden Tabelle wird die Beziehung zwischen den Invoke-Sqlcmd-Parametern und den sqlcmd-Optionen dargestellt:

Siehe auch

Verweis

Konzepte