Rundeck执行含Import-Module的PowerShell脚本失败问题求助

错误情况 #

• 已在目标服务器安装Microsoft.Online.SharePoint.PowerShell模块，但Rundeck执行含Import-Module的脚本时报错：

[ERROR ] Execution finished with the following error (winrm-exec.py:332)[root]
[ERROR ] Import-Module : The specified module 'Microsoft.Online.SharePoint.PowerShell' was not loaded because no valid module file was found in any module directory.

• 移除Import-Module命令后，出现新错误：

[ERROR ] Execution finished with the following error (winrm-exec.py:332)[root]
[ERROR ] Connect-SPOService : The term 'Connect-SPOService' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

用户提供的脚本 #

Set-ExecutionPolicy RemoteSigned -Scope Process -Force
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

#endregion
$username = "user_name"
$password = "password"
$siteUrl = "https://xxxx.sharepoint.com/"
# Connect to Azure AD
$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $username, $(convertto-securestring $password -asplaintext -force)
Connect-SPOService -Url $siteUrl -Credential $cred -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations -WarningAction SilentlyContinue

解决方向 #

1. 检查Rundeck执行的用户上下文

   • 模块可能安装在当前登录用户的Documents\WindowsPowerShell\Modules目录，但Rundeck使用本地系统账户或其他用户执行脚本，导致无法访问该目录。
   • 解决：将模块安装到全局模块目录（C:\Program Files\WindowsPowerShell\Modules或C:\Program Files\PowerShell\Modules，依PowerShell版本而定），确保所有用户可访问。

2. 指定模块完整路径加载

   • 直接在脚本中用绝对路径加载模块，示例：

     # 先在目标服务器运行Get-Module -ListAvailable Microsoft.Online.SharePoint.PowerShell获取版本号
     Import-Module "C:\Program Files\WindowsPowerShell\Modules\Microsoft.Online.SharePoint.PowerShell\<版本号>\Microsoft.Online.SharePoint.PowerShell.psd1"
     

3. 验证PowerShell版本兼容性

   • Microsoft.Online.SharePoint.PowerShell通常要求PowerShell 5.1或更高版本，检查Rundeck调用的PowerShell版本是否符合要求。
   • 可在脚本开头添加$PSVersionTable.PSVersion输出版本信息，确认执行环境的版本。

4. 手动添加模块路径到环境变量

   • WinRM执行的PowerShell会话可能未加载用户环境变量，导致模块路径未被包含，可在脚本中手动添加：

     $env:PSModulePath += ";C:\Program Files\WindowsPowerShell\Modules"
     Import-Module Microsoft.Online.SharePoint.PowerShell -Force
     

内容的提问来源于stack exchange，提问作者Lev