Azure Pipeline执行PowerShell脚本报错：'root'未被识别为Cmdlet

原因1：Azure Pipeline代理缺失Posh-SSH模块 #

你的脚本依赖Posh-SSH模块提供的New-SSHSession、Invoke-SSHCommand cmdlet，本地环境已安装该模块，但Azure Pipeline使用的代理机器（托管或自托管）未部署，导致执行失败，错误信息因输出截断显示为root相关报错。

修复方法： #

在PowerShell脚本开头添加模块安装逻辑：

# 检查并安装Posh-SSH模块
if (-not (Get-Module -ListAvailable -Name Posh-SSH)) {
    Install-Module -Name Posh-SSH -Force -AllowClobber -Scope CurrentUser
}
Import-Module Posh-SSH -Force

原因2：远程命令需root权限未加sudo #

appcfgset命令可能需要root权限执行，脚本中未添加sudo前缀，导致远程执行时权限不足，错误输出被PowerShell误解析为本地命令，出现root未识别的报错。

修复方法： #

修改UpdateConfigFile函数中的命令行，根据远程机器的sudo配置调整：

# 情况1：远程机器sudo无需密码
$Command = "sudo appcfgset clksrv_host " + $hostname

# 情况2：远程机器sudo需要密码（注意：明文传递密码有安全风险，仅在可信环境使用）
# $Command = "echo $GT4Password | sudo -S appcfgset clksrv_host " + $hostname

原因3：错误信息输出错位 #

Azure Pipeline中远程命令的输出与本地PowerShell的输出混合，导致错误信息显示错位，实际错误并非root未识别，而是远程命令执行失败的输出被误判为本地命令。

修复方法： #

为Invoke-SSHCommand添加结果校验，明确捕获远程执行的错误：

$sshResult = Invoke-SSHCommand -Index $SessionID.Sessionid -Command $Command
if ($sshResult.ExitStatus -ne 0) {
    throw "远程命令执行失败：$($sshResult.Error)"
}
Write-Host "远程命令执行输出：$($sshResult.Output)"

额外验证项 #

• 确认Azure Pipeline变量GT4user、GT4Pass已正确配置并传递，避免因变量空值导致凭证创建失败。
• 若使用自托管代理，检查代理机器的PowerShell执行策略，必要时添加：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
  

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