使用 Invoke-Sqlcmd 指令程式

使用 Invoke-Sqlcmd

Invoke-Sqlcmd 指令程式可讓您在 Windows PowerShell 環境中執行 sqlcmd 指令碼檔案。sqlcmd 可以執行的大多數作業也可以使用 Invoke-Sqlcmd 來執行。

這是呼叫 Invoke-Sqlcmd 來執行簡單查詢的範例，類似於指定 sqlcmd 及 -Q 和 -S 選項：

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

這是呼叫 Invoke-Sqlcmd 的範例，指定輸入檔並將輸出傳送到檔案中。這類似於指定 sqlcmd 及 -i 和 -o 選項：

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

這是使用 Windows PowerShell 陣列將多個 sqlcmd 指令碼變數傳給 Invoke-Sqlcmd 的範例。用於識別 SELECT 陳述式中 sqlcmd 指令碼變數的 "$" 字元已經使用 PowerShell 反勾號 "`" 逸出字元逸出：

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

這是使用適用於 Windows PowerShell 的 SQL Server 提供者導覽至 Database Engine 執行個體，然後使用 Windows PowerShell Get-Item 指令程式擷取此執行個體的 SMO Server 物件並將它傳遞給 Invoke-Sqlcmd 的範例：

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

-Query 參數是位置性參數而且不需要加以命名。如果傳遞給 Invoke-Sqlcmd 的第一個字串未命名，它就會被視為 -Query 參數。

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

Invoke-Sqlcmd 中的路徑內容

如果您沒有使用 -Database 參數，Invoke-Sqlcmd 的資料庫內容就會由呼叫此指令程式時作用中的路徑所設定。

例如，假設在本機電腦的預設執行個體中，Windows 帳戶的預設資料庫是 master。然後，下列命令會傳回 master：

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

下列命令則傳回 AdventureWorks2008R2：

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

當 Invoke-Sqlcmd 使用路徑資料庫內容時，它會提供警告。您可以使用 -SuppressProviderContextWarning 參數來關閉警告訊息。您可以使用 -IgnoreProviderContext 參數來告知 Invoke-Sqlcmd 一律使用預設資料庫進行登入。

比較 Invoke-Sqlcmd 和 sqlcmd 公用程式

Invoke-Sqlcmd 可用於執行可以使用 sqlcmd 公用程式執行的許多指令碼。但是，Invoke-Sqlcmd 執行所在的 Windows PowerShell 環境與 sqlcmd 執行所在的命令提示字元環境不同。Invoke-Sqlcmd 的行為已經過修改，可在 Windows PowerShell 環境中工作。

並非所有的 sqlcmd 命令都會在 Invoke-Sqlcmd 中實作。未實作的命令包含以下項目：:!!、:connect、:error、:out、:ed、:list、:listvar、:reset、:perftrace 和 :serverlist。

Invoke-Sqlcmd 不會初始化 sqlcmd 環境或指令碼變數，例如 SQLCMDDBNAME 或 SQLCMDWORKSTATION。

Invoke-Sqlcmd 不會顯示訊息 (例如 PRINT 陳述式的輸出)，除非您指定 Windows PowerShell -Verbose 共用參數。例如：

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

並非所有的 sqlcmd 參數都是 PowerShell 環境所需。例如，Windows PowerShell 會從指令程式格式化所有輸出，所以 Invoke-Sqlcmd 中不會實作用於指定格式化選項的 sqlcmd 參數。下表顯示 Invoke-Sqlcmd 參數與 sqlcmd 選項之間的關聯性：

請參閱

參考

概念