首页 > 解决方案 > Powershell 如何知道在哪里可以找到要导入的模块?

问题描述

我真的处于使用命令行开关和 powershell 东西的初学者水平。我正在使用 PowerShell API 从 C# 调用命令行开关。我看到了奇怪的行为。虽然在 stackoverfow 上的不同线程上,人们使用 Import-Command 或 PSImportModule 方法显式导入模块,但我可以查看 $env:PSModulePath 是否已经有一个程序集,它会自动加载。这种行为是默认情况下还是由于我忽略的标准配置。我在 ms 测试环境中运行单元测试。

我正在使用以下代码。

 System.Management.Automation.PowerShell _powerShellInstance
 _powerShellInstance.AddCommand("Connect-AzureRmAccount", false);
 var output = _powerShellInstance.Invoke();

 // Invoking my commandlets

 _powerShellInstance.AddCommand("Get-LinkParameter", false); 

上面的命令会自动从C:\Windows\system32\WindowsPowerShellModules\v1.0\Modules\. 我没有创建任何运行空间,也没有配置集。就在上面自动加载的东西。我需要确认 powershell 和运行空间的行为究竟如何。因为我需要弄清楚我需要如何在生产机器上安装我的命令行开关。生产机器上的单元测试如何访问我的命令行开关以完美加载。

标签: c#powershellcmdletsrunspace

解决方案


虽然显式加载您想要使用的模块是一种很好的做法Import-Module,但由于 Powershell 3.0 如果模块在 由 返回的位置之一可用$env:PSModulePath,则默认情况下,如果调用其 cmdlet 之一,它将自动加载。以下是不同路径的细分:

用户模块

$modulePath = "${env:UserProfile}\Documents\WindowsPowerShell\Modules" 此处安装的模块仅对当前用户的 Powershell 会话可用,默认情况下使用安装的模块Install-Module保存在此处。

所有用户模块

$modulePath = "${env:ProgramFiles}\WindowsPowerShell\Modules" 此处安装的模块可供任何用户的 Powershell 会话使用。

系统模块

$modulePath = "${env:SystemRoot}\system32\WindowsPowerShell\v1.0\Modules" 此处安装的模块在系统范围内可用于任何 Powershell 会话,但应保持清洁以供 Windows 管理。通常,您不想在此处安装自己的模块。

添加其他模块路径

您可以添加其他路径,$env:PSModulePath类似于修改$env:PATH变量以解析可执行路径的方式。它只是一个以分号;分隔的模块所在的目录字符串,如果模块在 中的任何路径可用$env:PSModulePath,Powershell 将知道在哪里可以找到它。事实上,您可能会看到其他已安装的工具可能已将自己的路径添加到$env:PSModulePath. 执行此操作的程序/工具集的一些示例是Microsoft SQL StudioMicrosoft System Center - Operations ManagerChef Development Kit.

导入不在路径上的模块

据我所知,您无法加载不属于$env:PSModulePath. 但是,您可以临时编辑$env:PSModulePath以包含带有您要加载的模块的目录。例如,如果您想导入TestModule从某个任意路径命名的模块:

$env:PSModulePath += ';C:\Path\To\Temporary\ModuleDirectory'
Import-Module TestModule

其中TestModule作为子文件夹存在C:\Path\To\Temporary\ModuleDirectory

当您准备好结束您的 Powershell 会话时,您不需要退出模块路径更改,因为上述更改是临时的。因此,您需要$env:PSModulePath在每个会话中进行修改,因此如果TestModule您希望始终使用某些东西,您可以将其复制到其中的其他目录之一$env:PSModulePath或永久添加C:\Path\To\Temporary\ModuleDirectoryPSModulePath环境变量中。

关于 UNC 路径的说明

您还可以将 UNC(网络)路径添加到$env:PSModulePath. 但是,我相信任何远程模块脚本仍然会受制于ExecutionPolicy系统上设置的 Powershell。

还有更多关于安装模块的信息

默认情况下,Install-Module将模块安装到用户模块目录,但您可以使用-Scope参数对此进行一些控制。例如,以下命令将更改模块的安装位置:

# Install to the current user location (default behavior if scope unspecified)
Install-Module -Scope CurrentUser $moduleName

# Install to the all users location (requires elevated permissions)
Install-Module -Scope AllUsers $moduleName

不幸的是,这只是 PowerShell 将帮助您安装模块的两个位置。系统模块对 PowerShell 的操作至关重要,不应由最终用户修改,添加到$env:PSModulePath的其他路径可能由 PowerShell 之外的软件管理,通常由 MSI 或其他安装程序管理。

此外,如果您编写的软件附带一个或多个 PowerShell 模块,最好让安装程序向系统添加一个新目录%PSModulePath%并将模块放在那里,而不是安装到标准的 AllUsers 或 CurrentUser 路径,因为这些确实意味着让最终用户随心所欲地进行管理。在这种情况下,让您的软件更新过程更新模块。这有利于防止意外修改模块或将模块删除为不兼容的版本。


推荐阅读