Invoke-Sqlcmd 指令程式

Invoke-Sqlcmd 是一種執行指令碼的 SQL Server Cmdlet，該指令碼包含了 sqlcmd 公用程式所支援之語言 (Transact-SQL 及 XQuery) 與命令的陳述式。

使用 Invoke-Sqlcmd

Invoke-Sqlcmd Cmdlet 可讓您在 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 Cmdlet 擷取此執行個體的 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;"

下列命令則傳回 AdventureWorks2012 ：

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

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

請參閱

參考

sqlcmd 公用程式

概念

使用 Database Engine Cmdlet

使用 sqlcmd 公用程式