本节书摘来自异步社区出版社《PowerShell V3—SQL Server 2012数据库自动化运维权威指南》一书中的第1章,第1.7节,作者:【加拿大】Donabel Santos,更多章节内容可以访问云栖社区“异步社区”公众号查看。
1.7 发现SQL相关的cmdlets和模块
为了有效地使用SQL Server和PowerShell工作,需要了解如何浏览和发现cmdlets、插件和模块。
1.7.1 准备
登录到SQL Server实例,进入PowerShell ISE。如果你更喜欢控制台,你也可以进入控制台。
1.7.2 如何做…
在这个方案中,我们将会列出SQL Server相关的命令和cmdlets。
1.为了发现SQL相关的cmdlets,在PowerShell编辑器中输入如下命令并运行。
#how many commands from modules that
#have SQL in the name
Get-Command -Module "*SQL*" | Measure-Object
#list all the SQL-related commands
Get-Command -Module "*SQL*" |
Select CommandType, Name, ModuleName |
Sort -Property ModuleName, CommandType, Name |
Format-Table –AutoSize
执行命令后,输出窗口将会出现类似如下截屏。
2.查看哪些模块被导入,在编辑器中输入如下语句并运行。
Get-Module -Name "*SQL*"
如果你已经在之前的步骤中用了这些cmdlets中的任何一个,你都会看到SQLPS和SQLASCMDLETS。因此,你需要在使用它们之前导入这些模块。
3.为了明确地导入模块,输入如下语句并运行。
Import-Module -Name "SQLPS"
注意,当你导入SQLPS时,SQLASCMDLETS将会被导入。
1.7.3 如何实现…
PowerShell的核心是cmdlets。cmdlet(读作commandlet)可以是编译的、可重用的.NET代码,可以是一个高级函数,也可以是一个专门执行特殊任务的工作流。所有的cmdlets遵循“动词-名词”命名规范。
PowerShell包含很多cmdlets,如果这些cmdlets不满足你的目的,还可以进步一扩展。
扩展PowerShell的传统方法是注册额外的插件。插件(snap-in)是一个包含了cmdlets的二进制文件或一个包含cmdlets的DLL文件。你可以构建.NET源码,通过编译来创建自己的插件,然后注册插件。使用它们之前,需要注册插件。插件是扩展PowerShell的流行方法。
下表总结了关于插件的常用任务。
从PowerShell V2开始,模块成为扩展PowerShell的更好方法。
模块是包含cmdlets、提供者、函数、变量和别名的包。在PowerShell V2中,默认情况下,模块不会被导入,所以需要的模块必须明确被导入。
有关模块的常用任务总结见下表。
PowerShell V3增强的属性之一是支持自动导入模块。你不需要总是在使用包含的命令之前明确导入模块。在脚本中使用cmdlet会触发PowerShell导入包含它的模块。
SQL Server 2012模块位于安装目录的PowerShell/Modules文件夹下。
1.7.4 更多…
下表显示了这个版本的SQLPS和SQLASCMDLETS cmdlets列表。
了解更多关于cmdlets的信息,使用Get-Help cmdlet。例如:
Get-Help "Invoke-Sqlcmd"
Get-Help "Invoke-Sqlcmd" -Detailed
Get-Help "Invoke-Sqlcmd" -Examples
Get-Help "Invoke-Sqlcmd" -Full
你也可以查阅有关SQL Server数据库引擎cmdlets的MSDN文章。
http://msdn.microsoft.com/en-us/library/cc281847.aspx
当你导入SQLPS模块时,一些程序集会导入到你的主机。
使用下面的脚本,可以获取导入了SQLPS模块的SQL Server相关程序集,它们在PowerShell V2和V3下都是有效的。
Import-Module SQLPS –DisableNameChecking
[appdomain]::CurrentDomain.GetAssemblies() |
Where {$_.FullName -match "SqlServer" } |
Select FullName
如果你想严格在V3环境下运行,可以利用如下简化的语法。
Import-Module SQLPS –DisableNameChecking
[appdomain]::CurrentDomain.GetAssemblies() |
Where FullName -match "SqlServer" |
Select FullName
下图将会显示所有导入的程序集,包括它们的公钥令牌。
有关运行PowerShell脚本的更多信息
默认情况下,PowerShell在受限模式(restricted)下运行,换句话说,它不能运行脚本。为了运行本书中的脚本,我们需要将执行策略设置为RemoteSigned。
Set-ExecutionPolicy RemoteSigned
如果将PowerShell代码保存到一个文件里,需要确保它的后缀名为.ps1,否则PowerShell将无法运行。理论上,给定的脚本文件名不会有空格。你可以从PowerShell控制台通过简单调用这个名字来运行这个脚本。例如,如果你在C:目录下有一个名为myscript.ps1的脚本,按如下方式调用:
PS C:\> .\myscript.ps1
如果文件或文件的路径中有空格,你需要将完整路径和文件名用单引号或双引号括起来,并且用调用操作符(&)。
PS C:\>&'.\my script.ps1'
如果你想保持脚本中的变量和函数,在内存中,使得它们在会话中全局可用,你需要用点号加载这个脚本。点号加载就是在文件名或者文件的路径前加上逗号和空格。
PS C:\>. .\myscript.ps1
PS C:\>. '.\my script.ps1'
有关混合程序集错误的更多信息
当运行用旧版.NET创建的命令时,可能会遇到一个错误。有趣的是,你可能会在PowerShell ISE运行脚本时看到它,但在Shell中则不一定。
Invoke-Sqlcmd: Mixed mode assembly is built against version 'V2.0.50727'
of the runtime and cannot be loaded in the 4.0 runtime without additional
configuration information.
解决这个问题的步骤如下。
1.打开“Windows Explorer”。
2.找出Windows PowerShell ISE安装目录。你可以通过单击“Start | All Programs | Accessories | Windows | PowerShell”,然后右击“Windows PowerShell ISE”菜单条目,然后选择“Properties”。
对于32位的ISE,默认路径为:
%windir%\sysWOW64\WindowsPowerShell\v1.0\PowerShell_ISE.exe
对于64位的ISE,默认路径为:
%windir%\system32\WindowsPowerShell\v1.0\PowerShell_ISE.exe
3.进入PowerShell ISE安装目录。
4.创建一个空的文件,命名为powershell_ise.exe.config。
5.添加如下片段到内容中,并保存文件。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup useLegacyV2RuntimeActivationPolicy="true">
<supportedRuntime version="v4.0" />
</startup>
<runtime>
<generatePublisherEvidence enabled="false" />
</runtime>
</configuration>
6.重新打开PowerShell ISE,并重试失败的命令。