##[error]The term 'pwsh.exe' is not recognized as the name of a cmdlet, function, script file, or operable program.

[PitterG]

I've followed the whitepaper for installing and configuring.
I'm using a self-hosted DevOps Agent running only Powershell 5.1

As I understand, all installations should be using powershell 5.1 only.
But...
when running build pipeline for the very first time i get an errror on the 'Prepare Agent (Install Modules)' task.

Starting: Prepare Agent (Install Modules)

Task : PowerShell
Description : Run a PowerShell script on Linux, macOS, or Windows
Version : 2.262.0
Author : Microsoft Corporation
Help : https://docs.microsoft.com/azure/devops/pipelines/tasks/utility/powershell

Generating script.
Formatted command: . 'C:_M365DSC\agent_work\1\s\CICD\Scripts\DeployModules.ps1'
##[error]The term 'pwsh.exe' 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.
Finishing: Prepare Agent (Install Modules)

Looking into 'build-template.yaml' i see the following configuration for the powershell task

  # Make sure all required modules are installed
  - task: PowerShell@2
    displayName: 'Prepare Agent (Install Modules)'
    inputs:
      targetType: 'filePath'
      filePath: './CICD/Scripts/DeployModules.ps1'
      errorActionPreference: 'Stop'
      failOnStderr: true
      pwsh: true

Setting pwsh is set to true. This means that the task should be run with powershell core and not with powershell.exe.

So do I have to install powershell 7.x on my agent or can I simply the the parameter 'pwsh' to false?

[PitterG]

When changing 'pwsh' to false the following error occurs:

"C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Unrestricted -Command ". 'C:_M365DSC\agent_work_temp\e7bb963d-f3c3-427c-a9d8-fc8a3062927b.ps1'"
ERROR: Could not load library 'ModuleFast' (The version of Windows PowerShell on this computer is '5.1.26100.6584'. The module 'C:_M365DSC\agent_work\1\s\CICD\Scripts\ModuleFast\ModuleFast.psd1' requires a minimum Windows PowerShell version of '7.2' to run. Verify that you have the minimum required version of Windows PowerShell installed, and then try again). Exiting.
##[error]PowerShell exited with code '1'.
Finishing: Prepare Agent (Install Modules)

So, seems to be needed

[stone-hiro]

It seems that Microsoft365 DSC supports powershell 7.3

https://microsoft365dsc.com/user-guide/get-started/prerequisites/

[FabienTschanz]

@stone-hiro Exporting is supported with PowerShell 7. Unfortunately, the drift check and apply mechanism with Start-DscConfiguration (using the Local Configuration Manager) still requires Windows PowerShell 5.1.

As for the issue here, PowerShell 7 is (as it seems) required to install the modules. I'd start with installing it on the self-hosted DevOps Agent and then try again. There is most likely no other way because the solution is designed this way.

[PitterG]

Adding PS 7 solved the issue.

Issue can be closed