一、概述
SQL Server 2012 提供了一个名为 sqlps 的 Windows PowerShell 模块,该模块用于将 SQL Server 组件导入到 Windows PowerShell 2.0 环境或脚本中。sqlps 模块提供一组 SQL Server cmdlet ,支持各种操作,如运行包含 Transact-SQL 或 XQuery 语句的 sqlcmd 脚本。
二、加载模块
1、SQL Server 2008 R2 插件
从 SQL Server 2005 开始,就提供了一个 Invoke-Sqlcmd 的 Cmdlet,功能类似于早期的SQLCMD,可以直接运行。SQL Server 2008 默认的安装路径为C:\Program Files\Microsoft SQL Server\100\Tools\Binn。运行SQLPS.exe,直接进入名为“SQLSERVER:”的命名空间。
也可以在 Windows PowerShell 中手动加载插件。
PS C:\Users\Administrator> Get-PSSnapin -Registered
Name : SqlServerCmdletSnapin100
PSVersion : 1.0
Description : This is a PowerShell snap-in that includes various SQL Server cmdlets.
Name : SqlServerProviderSnapin100
PSVersion : 1.0
Description : SQL Server Provider
PS C:\Users\Administrator> Add-PSSnapin sqlserverprovidersnapin100
PS C:\Users\Administrator> Add-PSSnapin sqlservercmdletsnapin100
PS C:\Users\Administrator> Get-Help Invoke-Sqlcmd -Detailed
2、SQL Server 2012
SQL Server 2012 仍然保留SQLPS.exe,默认安装路径为 C:\Program Files\Microsoft SQL Server\110\Tools\Binn ,版本为11.0.2100.60 。
SQL Server 2012 以模块的形式存在,可以在PowerShell 手动加载SQLPS模块,实现在PowerShell 访问 SQL 组件和功能。
PS C:\Users\Administrator> Get-Module -ListAvailable
ModuleType Name ExportedCommands
---------- ---- ----------------
Manifest BitsTransfer {}
Manifest PSDiagnostics {}
Manifest SQLASCMDLETS {}
Manifest SQLPS {}
PS C:\Users\Administrator> Set-ExecutionPolicy RemoteSigned
执行策略更改
执行策略可以防止您执行不信任的脚本。更改执行策略可能会使您面临 about_Execution_Policies
帮助主题中所述的安全风险。是否要更改执行策略?
[Y] 是(Y) [N] 否(N) [S] 挂起(S) [?] 帮助 (默认值为“Y”): y
PS C:\Users\Administrator> Import-Module SQLPS
警告: 本地计算机没有 Analysis Services 的活动实例。
警告: 有些导入的命令名包含未批准的动词,这些动词可能会导致命令名不易被发现。请使用 Verbose
参数了解详细信息,或键入 Get-Verb 查看已批准的动词列表。
PS SQLSERVER:\>
注:加载了模块之后,提示符显示已经切换到名为“SQLSERVER:”的命名空间。
在导入模块时可以指定参数,隐藏警告信息。例如:
PS C:\Users\Administrator> Import-Module SQLPS -DisableNameChecking
三、执行一个查询
1、SQL Server 2008 R2
下面的例子是执行一个简单的查询,数据库实例为本机(localhost)的默认实例,使用Windows集成身份验证,访问的数据库是master。
PS C:\Users\Administrator> Invoke-Sqlcmd -query "select * from sys.databases" -Database master -ServerInstance localhost | Format-Table
name database_id source_data owner_sid create_date compatibili collation_n user_access user_access is_read_onl
base_id ty_level ame _desc y
---- ----------- ----------- --------- ----------- ----------- ----------- ----------- ----------- -----------
master 1 {1, 0, 0... 2003/4/8... 100 SQL_Lati... 0 MULTI_USER False
tempdb 2 {1, 0, 0... 2013/4/2... 100 SQL_Lati... 0 MULTI_USER False
model 3 {1, 0, 0... 2003/4/8... 100 SQL_Lati... 0 MULTI_USER False
msdb 4 {1, 0, 0... 2010/4/2... 100 SQL_Lati... 0 MULTI_USER False
ReportSe... 5 {1, 5, 0... 2013/4/2... 100 Latin1_G... 0 MULTI_USER False
ReportSe... 6 {1, 5, 0... 2013/4/2... 100 Latin1_G... 0 MULTI_USER False
2、SQL Server 2012
SQL Server 2012仍然可以在PowerShell中执行Invoke-Sqlcmd。也可以使用模块中可用的命令和功能。以下命令可以列出所有SQLPS模块中的命令和功能。
PS SQLSERVER:\> Get-Command -Module SQLPS
CommandType Name Definition
----------- ---- ----------
Cmdlet Add-SqlAvailabilityDatabase Add-SqlAvailabilityDatabase [[-Path] <String[]>]...
Cmdlet Add-SqlAvailabilityGroupListenerStaticIp Add-SqlAvailabilityGroupListenerStaticIp [[-Path...
Cmdlet Backup-SqlDatabase Backup-SqlDatabase [-Database] <String> [[-Backu...
Cmdlet Convert-UrnToPath Convert-UrnToPath [-Urn] <String> [-Verbose] [-D...
Cmdlet Decode-SqlName Decode-SqlName [-SqlName] <String> [-Verbose] [-...
Cmdlet Disable-SqlAlwaysOn Disable-SqlAlwaysOn [[-Path] <String>] [-NoServi...
Cmdlet Enable-SqlAlwaysOn Enable-SqlAlwaysOn [[-Path] <String>] [-NoServic...
Cmdlet Encode-SqlName Encode-SqlName [-SqlName] <String> [-Verbose] [-...
Cmdlet Invoke-PolicyEvaluation Invoke-PolicyEvaluation [-Policy] <PSObject> [-A...
Cmdlet Invoke-Sqlcmd Invoke-Sqlcmd [[-Query] <String>] [-ServerInstan...
Cmdlet Join-SqlAvailabilityGroup Join-SqlAvailabilityGroup [-Name] <String> [[-Pa...
Cmdlet New-SqlAvailabilityGroup New-SqlAvailabilityGroup [-Name] <String> [[-Pat...
Cmdlet New-SqlAvailabilityGroupListener New-SqlAvailabilityGroupListener [-Name] <String...
Cmdlet New-SqlAvailabilityReplica New-SqlAvailabilityReplica [-Name] <String> [[-P...
Cmdlet New-SqlHADREndpoint New-SqlHADREndpoint [-Name] <String> [[-Path] <S...
Cmdlet Remove-SqlAvailabilityDatabase Remove-SqlAvailabilityDatabase [-Path] <String[]...
Cmdlet Remove-SqlAvailabilityGroup Remove-SqlAvailabilityGroup [-Path] <String[]> [...
Cmdlet Remove-SqlAvailabilityReplica Remove-SqlAvailabilityReplica [-Path] <String[]>...
Cmdlet Restore-SqlDatabase Restore-SqlDatabase [-Database] <String> [[-Back...
Cmdlet Resume-SqlAvailabilityDatabase Resume-SqlAvailabilityDatabase [[-Path] <String[...
Cmdlet Set-SqlAvailabilityGroup Set-SqlAvailabilityGroup [[-Path] <String>] [-Au...
Cmdlet Set-SqlAvailabilityGroupListener Set-SqlAvailabilityGroupListener [[-Path] <Strin...
Cmdlet Set-SqlAvailabilityReplica Set-SqlAvailabilityReplica [[-Path] <String>] [-...
Cmdlet Set-SqlHADREndpoint Set-SqlHADREndpoint [[-Path] <String>] [-Owner <...
Function SQLSERVER: Set-Location SQLSERVER:
Cmdlet Suspend-SqlAvailabilityDatabase Suspend-SqlAvailabilityDatabase [[-Path] <String...
Cmdlet Switch-SqlAvailabilityGroup Switch-SqlAvailabilityGroup [[-Path] <String[]>]...
Cmdlet Test-SqlAvailabilityGroup Test-SqlAvailabilityGroup [[-Path] <String[]>] [...
Cmdlet Test-SqlAvailabilityReplica Test-SqlAvailabilityReplica [[-Path] <String[]>]...
Cmdlet Test-SqlDatabaseReplicaState Test-SqlDatabaseReplicaState [[-Path] <String[]>...
如需查看某个命令的详细技术信息,可以执行:
PS SQLSERVER:\> Get-Help Backup-SqlDatabase -full
三、示例:备份一个数据库
1、使用Invoke-Sqlcmd
PS SQLSERVER:\> Invoke-Sqlcmd "backup database master to disk = 'c:\backup\master.bak' "
2、SQL Server 2012 模块中的命令
PS SQLSERVER:\> Backup-SqlDatabase -ServerInstance localhost -Database master -BackupFile "c:\backup\master.bak"
四、从SSMS启动PowerShell
可以在 SQL Server Management Studio 中从“对象资源管理器”启动 Windows PowerShell 会话,加载 sqlps 模块,并将路径上下文设置为“对象资源管理器”树中的相关节点。
注:从 SSMS 打开 PowerShell 时,它不会使用管理员权限运行,这可能会阻止某些活动(如调用 WMI)。