Sitecore 9.0.2安装脚本运行时出现证书相关报错该如何解决
Sitecore 9.0.2安装证书任务缺失报错解决方案
核心报错信息:
Install-SitecoreConfiguration : No registration found for extension 'NewRootCertificate' of type 'Task'.
触发报错语句:Install-SitecoreConfiguration @certParams -Verbose
问题根因
该报错是由于安装环境缺少与Sitecore 9.0.2版本匹配的Sitecore安装框架(SIF)依赖模块,或模块版本不兼容导致证书生成任务无法被识别。
排查步骤
- 检查已安装的SIF版本:执行PowerShell命令
Get-Module -Name SitecoreInstallFramework -ListAvailable,确认是否存在1.2.1版本(Sitecore 9.0.2唯一适配的SIF版本)。 - 检查SitecoreFundamentals模块安装情况:
NewRootCertificate任务属于该模块,执行Get-Module -Name SitecoreFundamentals -ListAvailable确认是否存在1.2.1版本。 - 检查PowerShell执行策略:执行
Get-ExecutionPolicy,若返回Restricted则会阻止第三方模块加载,是触发报错的常见原因之一。
解决步骤
卸载不兼容的模块版本
若已安装其他版本的SIF或SitecoreFundamentals,先执行卸载命令:
Uninstall-Module -Name SitecoreInstallFramework -AllVersions -Force Uninstall-Module -Name SitecoreFundamentals -AllVersions -Force
安装匹配版本的依赖模块
执行以下命令安装适配Sitecore 9.0.2的模块版本:
Install-Module -Name SitecoreInstallFramework -RequiredVersion 1.2.1 -Force Install-Module -Name SitecoreFundamentals -RequiredVersion 1.2.1 -Force
调整PowerShell执行策略
若执行策略受限,执行以下命令调整为允许本地脚本运行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
弹窗确认时输入Y即可生效。
重新加载模块后执行安装
执行以下命令强制加载对应版本模块,避免缓存导致的识别失败:
Import-Module SitecoreInstallFramework -RequiredVersion 1.2.1 -Force Import-Module SitecoreFundamentals -RequiredVersion 1.2.1 -Force
之后重新运行你的Sitecore安装脚本即可。
验证方法
执行命令Get-Command -Module SitecoreFundamentals,若输出列表中存在NewRootCertificate相关定义,说明问题已修复。
内容的提问来源于stack exchange,提问作者Kubanthiran
相关产品推荐
相关产品推荐

