PowerShellGet系列(二)：用PowerShellGet管理你的模块包
转载请注明出处，不胜感激！关于PowerShell的文章，我也同步发布在我的微信公共订阅号里，欢迎关注：[一起PowerShell]
上一篇在PowerShellGet系列中【PowerShellGet系列(一)：PowerShell的最佳管理能手】文章中，我们介绍了有关什么是PowerShellGet，今天这篇我们就来看看如何操作PowerShellGet模块里的命令。
不过在正式介绍里面的相关命令操作时，先让我们来简单回顾一下什么是PowerShellGet。
PowerShellGet是可以用来查找，安装，更新，管理等操作PowerShell模块与脚本的一个套件包，也就是所谓的管理PowerShell的包管理器。PowerShellGet里内置了一系列用于管理PowerShell模块与脚本的相关命令。用户可以使用PowerShellGet内的相关命令获取在线的PowerShell模块和脚本。
大家知道了什么是PowerShellGet，按照上面解释的说法，那是不是说明它里面所包含的Cmdlets就是各种操作的相关命令。让我使用Get-Command -Module PowerShellGet命令行来查看下里面包含的命令。
PS C:\Users\Administrator> Get-Command -Module PowerShellGet
CommandType Name Version Source
----------- ---- ------- ------
Function Find-Command 1.0.0.1 PowerShellGet
Function Find-DscResource 1.0.0.1 PowerShellGet
Function Find-Module 1.0.0.1 PowerShellGet
Function Find-RoleCapability 1.0.0.1 PowerShellGet
Function Find-Script 1.0.0.1 PowerShellGet
Function Get-InstalledModule 1.0.0.1 PowerShellGet
Function Get-InstalledScript 1.0.0.1 PowerShellGet
Function Get-PSRepository 1.0.0.1 PowerShellGet
Function Install-Module 1.0.0.1 PowerShellGet
Function Install-Script 1.0.0.1 PowerShellGet
Function New-ScriptFileInfo 1.0.0.1 PowerShellGet
Function Publish-Module 1.0.0.1 PowerShellGet
Function Publish-Script 1.0.0.1 PowerShellGet
Function Register-PSRepository 1.0.0.1 PowerShellGet
Function Save-Module 1.0.0.1 PowerShellGet
Function Save-Script 1.0.0.1 PowerShellGet
Function Set-PSRepository 1.0.0.1 PowerShellGet
Function Test-ScriptFileInfo 1.0.0.1 PowerShellGet
Function Uninstall-Module 1.0.0.1 PowerShellGet
Function Uninstall-Script 1.0.0.1 PowerShellGet
Function Unregister-PSRepository 1.0.0.1 PowerShellGet
Function Update-Module 1.0.0.1 PowerShellGet
Function Update-ModuleManifest 1.0.0.1 PowerShellGet
Function Update-Script 1.0.0.1 PowerShellGet
Function Update-ScriptFileInfo 1.0.0.1 PowerShellGet
我们获得了各类用于管理的相关命令，为了方便查看我们用下面的命令做些编排以方便梳理。
PS C:\Users\Administrator> Get-Command -Module PowerShellGet | Group-Object -Property Verb
Count Name Group
----- ---- -----
5 Find {Find-Command, Find-DscResource, Find-Module, Find-RoleCapability...}
3 Get {Get-InstalledModule, Get-InstalledScript, Get-PSRepository}
2 Install {Install-Module, Install-Script}
1 New {New-ScriptFileInfo}
2 Publish {Publish-Module, Publish-Script}
1 Register {Register-PSRepository}
2 Save {Save-Module, Save-Script}
1 Set {Set-PSRepository}
1 Test {Test-ScriptFileInfo}
2 Uninstall {Uninstall-Module, Uninstall-Script}
1 Unregister {Unregister-PSRepository}
4 Update {Update-Module, Update-ModuleManifest, Update-Script, Update-ScriptFileInfo}
大家可以看到，有Find(查找), Get(获取), Install(安装), New(新建), Publish(发布), Register(注册), Save(保存), Set(设置), Test(检查), Uninstall(卸载), Unregister(注销), Update(更新)一共包含了12大类的功能管理，几乎你可以用PowerShellGet来管理你整个PowerShell了。因为里面涵盖的内容非常多，所以我打算抽其中部分方面来介绍下。
好吧，我突然想到想用Find-Module查看PowerShellGet的所有包含版本号，因为PowerShellGet的数据源是PSGallery在线站点，所以它会连接PSGallery在线站点去获取我们的数据包，下面列出了目前站点上收录的可用版本号。
PS C:\Users\Administrator> Find-Module -Name PowerShellGet -AllVersions
Version Name Repository Description
------- ---- ---------- -----------
1.1.2.0 PowerShellGet PSGallery PowerShell module with commands for discovering,..
1.1.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering,..
1.1.0.0 PowerShellGet PSGallery PowerShell module with commands for discovering,..
我好像记得我当前电脑里的PowerShellGet不是最新的呢，让我用Get-Module查看下PowerShellGet版本号确认下吧。
PS C:\Users\Administrator> Get-Module -Name PowerShellGet
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 1.0.0.1 PowerShellGet {Find-Command, Find-DscResource, Find-Module, Find-RoleCap..
果然不是最新的，我电脑里的版本还是1.0.0.1，而之前我用Find-Module列出的在线版本号最新的已经到1.1.2.0了，赶紧升级下看看是不是又多了什么新功能。怎么升级呢？我想到了Update-Module的命令
PS C:\Users\Administrator> Update-Module -Name PowerShellGet -RequiredVersion 1.1.2.0
Update-Module : Module 'PowerShellGet' was not installed by using Install-Module, so it cannot be updated.
At line:1 char:1
+ Update-Module -Name PowerShellGet -RequiredVersion 1.1.2.0
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (PowerShellGet:String) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : ModuleNotInstalledUsingInstallModuleCmdlet,Update-Module
什么情况？居然报错了，提示Module ‘PowerShellGet’ was not installed by using Install-Module, so it cannot be updated. 这段错误提示告诉我，我要升级的PowerShellGet模块并没有通过Install-Module来安装（由于我们目前自带的PowerShellGet是安装WMF 5.0时自带的），所以不能被升级，也就是只有通过Install-Module方式来安装的模块才可以配合Update-Module更新。为了验证下，我用Get-InstalledModule命令查看下，果真下面列出的安装模块列表里显示我之前没用Install-Module方式安装过PowerShellGet模块。
PS C:\Users\Administrator> Get-InstalledModule
Version Name Repository Description
------- ---- ---------- -----------
0.1.0.1 AppxGet PSGallery Powershell Package Management (OneGet) Provider ...
1.5.1 AzureRM PSGallery Azure Resource Manager Module
0.5 GitHubProvider PSGallery GitHub-as-a-Package - PackageManagement PowerShe...
1.1.3.0 PackageManagement PSGallery PackageManagement (a.k.a. OneGet) is a new way t...
既然知道原因了那就简单了，马上用Install-Module安装吧。
PS C:\Users\Administrator> Install-Module -Name PowerShellGet -RequiredVersion 1.1.2.0
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its
InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from
'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): N
咦，这又什么情况？提示You are installing the modules from an untrusted repository. 我正要安装的模块包来自于一个未被信任的仓库来源。虽然我们输入 “Y” 参数可以继续执行，因为我们知道这是安全的。但是我还是想让它所以，这里我还是输入 “N” 先不继续安装。那怎么解决信任问题呢？按照刚才的错误提示用Set-PSRepository来操作，将PSGallery设置为可信任源。
PS C:\Users\Administrator>> Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
再用下面的命令验证查看下确实已经为信任级别了。
PS C:\Users\Administrator>> Get-PSRepository
Name InstallationPolicy SourceLocation
---- ------------------ --------------
PSGallery Trusted https://www.powershellgallery.com/api/v2/
现在，终于可以安装PowerShellGet模块了，不过为了后续给大家介绍如何更新模块，我在这里就刻意安装一个非最新版本1.1.0.0的PowerShellGet，等等再来升级它。
PS C:\Users\Administrator> Install-Module -Name PowerShellGet -RequiredVersion 1.1.0.0
然后再用Update-Module来升级到指定的最新版本。
PS C:\Users\Administrator> Update-Module -Name PowerShellGet -RequiredVersion 1.1.2.0
就是这么简单，我用Get-Module配合ListAvaliable参数居然发现有3个版本，这是因为在PowerShell 5.0中考虑到了兼容性已经支持了相同模块但是多版本的功能。
PS C:\Users\Administrator> Get-Module -Name PowerShellGet -ListAvailable
Directory: C:\Program Files\WindowsPowerShell\Modules
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 1.1.2.0 PowerShellGet {Install-Module, Find-Module, Save-Module, Update-Module...}
Script 1.1.0.0 PowerShellGet {Install-Module, Find-Module, Save-Module, Update-Module...}
Script 1.0.0.1 PowerShellGet {Install-Module, Find-Module, Save-Module, Update-Module...}
总结
大致的介绍说完了，虽然只是一个安装升级模块的过程出现了点小插曲，但在这过程中我们却用到了许多相关命令。让我们总结下，我们用Find-Module来查找在线仓库里可用的模块版本。然后用Get-Module获得当前的版本信息号以此来比较是否需要更新。接着我们用Update-Module来更新模块，但知道了一个重要的点一旦能用Update-Module更新的模块包前提必须都是要用Install-Module方式来安装的。在安装的过程中我们用Set-PSRepository设置可信任的安装源，最后终于可以顺利安装了。