Invoke-SqlCmd2 by Chad Miller 17 months ago (modification of post by Chad Miller view diff)
View followups from Chad Miller | diff | embed code: <script type="text/javascript" src="http://PoshCode.org/embed/2111"></script>download | new post
Modeled after SQL Server 2008 Invoke-Sqlcmd, but fixes bug in QueryTimeout.
- #######################
- <#
- .SYNOPSIS
- Runs a T-SQL script.
- .DESCRIPTION
- Runs a T-SQL script. Invoke-Sqlcmd2 only returns message output, such as the output of PRINT statements when -verbose parameter is specified
- .INPUTS
- None
- You cannot pipe objects to Invoke-Sqlcmd2
- .OUTPUTS
- System.Data.DataTable
- .EXAMPLE
- Invoke-Sqlcmd2 -ServerInstance "MyComputer\MyInstance" -Query "SELECT login_time AS 'StartTime' FROM sysprocesses WHERE spid = 1"
- This example connects to a named instance of the Database Engine on a computer and runs a basic T-SQL query.
- StartTime
- -----------
- 2010-08-12 21:21:03.593
- .EXAMPLE
- Invoke-Sqlcmd2 -ServerInstance "MyComputer\MyInstance" -InputFile "C:\MyFolder\tsqlscript.sql" | Out-File -filePath "C:\MyFolder\tsqlscript.rpt"
- This example reads a file containing T-SQL statements, runs the file, and writes the output to another file.
- .EXAMPLE
- Invoke-Sqlcmd2 -ServerInstance "MyComputer\MyInstance" -Query "PRINT 'hello world'" -Verbose
- This example uses the PowerShell -Verbose parameter to return the message output of the PRINT command.
- VERBOSE: hello world
- Version History
- v1.0 - Chad Miller - Initial release
- v1.1 - Chad Miller - Fixed Issue with connection closing
- v1.2 - Chad Miller - Added inputfile, SQL auth support, connectiontimeout and output message handling. Updated help documentation
- #>
- function Invoke-Sqlcmd2
- {
- [CmdletBinding()]
- param(
- [Parameter(Position=0, Mandatory=$true)] [string]$ServerInstance,
- [Parameter(Position=1, Mandatory=$false)] [string]$Database,
- [Parameter(Position=2, Mandatory=$false)] [string]$Query,
- [Parameter(Position=3, Mandatory=$false)] [string]$Username,
- [Parameter(Position=4, Mandatory=$false)] [string]$Password,
- [Parameter(Position=5, Mandatory=$false)] [Int32]$QueryTimeout=600,
- [Parameter(Position=6, Mandatory=$false)] [Int32]$ConnectionTimeout=15,
- [Parameter(Position=7, Mandatory=$false)] [ValidateScript({test-path $_})] [string]$InputFile
- )
- if ($InputFile)
- {
- $filePath = $(resolve-path $InputFile).path
- $Query = [System.IO.File]::ReadAllText("$filePath")
- }
- $conn=new-object System.Data.SqlClient.SQLConnection
- if ($Username)
- { $ConnectionString = "Server={0};Database={1};User ID={2};Password={3};Trusted_Connection=False;Connect Timeout={4}" -f $ServerInstance,$Database,$Username,$Password,$ConnectionTimeout }
- else
- { $ConnectionString = "Server={0};Database={1};Integrated Security=True;Connect Timeout={2}" -f $ServerInstance,$Database,$ConnectionTimeout }
- $conn.ConnectionString=$ConnectionString
- #Following EventHandler is used for PRINT and RAISERROR T-SQL statements. Executed when -Verbose parameter specified by caller
- if ($PSBoundParameters.Verbose)
- {
- $conn.FireInfoMessageEventOnUserErrors=$true
- $handler = [System.Data.SqlClient.SqlInfoMessageEventHandler] {Write-Verbose "$($_)"}
- $conn.add_InfoMessage($handler)
- }
- $conn.Open()
- $cmd=new-object system.Data.SqlClient.SqlCommand($Query,$conn)
- $cmd.CommandTimeout=$QueryTimeout
- $ds=New-Object system.Data.DataSet
- $da=New-Object system.Data.SqlClient.SqlDataAdapter($cmd)
- [void]$da.fill($ds)
- $conn.Close()
- $ds.Tables
- }
Submit a correction or amendment below (click here to make a fresh posting)
After submitting an amendment, you'll be able to view the differences between the old and new posts easily.
PowerShell Code Repository