Invoke-Sqlcmd

运行包含 SQL Server SQLCMD 实用工具支持的语句的脚本。

语法

Default (默认值)

Invoke-Sqlcmd
    [-ServerInstance <PSObject>]
    [-Database <String>]
    [-EncryptConnection]
    [-Username <String>]
    [-Password <String>]
    [[-Query] <String>]
    [-QueryTimeout <Int32>]
    [-ConnectionTimeout <Int32>]
    [-ErrorLevel <Int32>]
    [-SeverityLevel <Int32>]
    [-MaxCharLength <Int32>]
    [-MaxBinaryLength <Int32>]
    [-AbortOnError]
    [-DedicatedAdministratorConnection]
    [-DisableVariables]
    [-DisableCommands]
    [-HostName <String>]
    [-NewPassword <String>]
    [-Variable <String[]>]
    [-InputFile <String>]
    [-OutputSqlErrors <Boolean>]
    [-IncludeSqlUserErrors]
    [-SuppressProviderContextWarning]
    [-IgnoreProviderContext]
    [<CommonParameters>]

说明

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

示例

示例 1:连接到命名实例并运行脚本

PS C:\> Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MainInstance"
 TimeOfQuery
 -----------
 5/13/2010 8:49:43 PM

此命令连接到计算机上的 SQL 数据库引擎的命名实例,并运行基本的 Transact-SQL 脚本。

示例 2:调用脚本文件中的命令,并将输出保存在文本文件中

PS C:\> Invoke-Sqlcmd -InputFile "C:\ScriptFolder\TestSqlCmd.sql" | Out-File -FilePath "C:\ScriptFolder\TestSqlCmd.rpt"
Output sent to TestSqlCmd.rpt.

此命令读取包含 Transact-SQL 语句和 SQLCMD 命令的文件,运行该文件,并将输出写入另一个文件。 输出文件可能包含专有信息,因此应使用适当的 NTFS 权限保护输出文件。

示例 3:调用脚本并从字符串传入变量值

PS C:\> $StringArray = "MYVAR1='String1'", "MYVAR2='String2'"
PS C:\> Invoke-Sqlcmd -Query "SELECT `$(MYVAR1) AS Var1, `$(MYVAR2) AS Var2;" -Variable $StringArray
Var1     Var2
----     ----
String1  String2

此命令使用字符串数组作为 变量 参数的输入。 该数组定义多个 SQLCMD 变量。 SELECT 语句中标识 SQLCMD 变量的 $ 符号是使用后刻度 (') 字符进行转义的。

示例 4:调用脚本并从 SQL 数据库引擎传入变量

PS C:\>Set-Location "SQLSERVER:\SQL\MyComputer\MainInstance"
PS C:\>Invoke-Sqlcmd -Query "SELECT SERVERPROPERTY('MachineName') AS ComputerName;" -ServerInstance (Get-Item .)
 ComputerName
 ------------
 MyComputer

此命令使用 Set-Location 导航到 SQL 数据库引擎实例的 SQL Server Windows PowerShell 提供程序路径。 然后,它调用 Get-Item 来检索 SQL Management Object Server 对象,以用作 Invoke-SqlcmdServerInstance 参数。

示例 5:运行查询并显示详细输出

PS C:\> Invoke-Sqlcmd -Query "PRINT N'abc'" -Verbose
VERBOSE: abc

此命令使用 Windows PowerShell Verbose 参数返回 SQL PRINT 命令的消息输出。

示例 6:使用位置字符串作为输入调用命令

PS C:\> Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"
 WARNING: Using provider context. Server = MyComputer, Database = AdventureWorks2014.

 DatabaseName
 ------------
 AdventureWorks2014

此命令使用位置字符串向 Query 参数提供输入。 它还演示 Invoke-Sqlcmd 如何使用当前路径将数据库上下文设置为 AdventureWorks2014。

参数

-AbortOnError

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConnectionTimeout

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Database

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DedicatedAdministratorConnection

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisableCommands

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisableVariables

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EncryptConnection

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ErrorLevel

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HostName

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IgnoreProviderContext

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IncludeSqlUserErrors

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputFile

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaxBinaryLength

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaxCharLength

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NewPassword

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OutputSqlErrors

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Password

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Query

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-QueryTimeout

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ServerInstance

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SeverityLevel

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SuppressProviderContextWarning

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Username

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Variable

Invoke-Sqlcmd cmdlet 运行一个脚本,其中包含 SQL Server SQLCMD 实用工具支持的语言和命令。 支持的命令是 Transact-SQL 语句和数据库引擎支持的 XQuery 语法的子集。 此 cmdlet 还接受 SQLCMD 本机支持的许多命令,例如 GO 和 QUIT。 此 cmdlet 还接受 SQLCMD 脚本变量,例如 SQLCMDUSER。 默认情况下,此 cmdlet 不设置 SQLCMD 脚本变量。

此 cmdlet 不支持使用主要与交互式脚本编辑相关的命令。 不支持的命令包括:!, :connect、:error、:out、:ed、:list、:listvar、:reset、:p erftrace 和 :serverlist。

运行此 cmdlet 时,脚本返回的第一个结果集显示为格式化表。 如果后续结果集包含的列列表与第一列列表不同,则不会显示这些结果集。 如果第一个集后的后续结果集具有相同的列列表,则其行将追加到包含第一个结果集返回的行的格式化表中。

可以通过指定 Verbose 参数来显示 SQL Server 消息输出,例如 SQL PRINT 语句生成的输出。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSObject

输出

undefined

格式化表