2 min read.

This article explains one possible reason why you might run into an error like “Variable reference is not valid. ‘:’ was not followed by a valid variable name character. Consider using ${} to delimit the name” when using a PowerShell task in an Azure DevOps pipeline. Confusingly, the offending line might be this:

Write-Host ('##vso[task.debug]$LASTEXITCODE: {0}' -f $LASTEXITCOD …

Not something you even have in your script! What gives?

Problem

Table of Contents

Let’s take a closer look at the errors you might run into.

The way Azure DevOps outputs PowerShell errors is not pretty. It might look something like below:

##[error]ParserError: /home/vsts/work/_temp/4954678d-6ebb-48eb-93df-b799c6c58eb4.ps1:35
Line |
  35 |      Write-Host ('##vso[task.debug]$LASTEXITCODE: {0}' -f $LASTEXITCOD …
     |                                    ~~~~~~~~~~~~~~
     | Variable reference is not valid. ':' was not followed by a
     | valid variable name character. Consider using ${} to delimit
     | the name.

And if you have system.debug enabled, your errors are going to be even worse and even more difficult to understand! Oh, and there’s going to be a LOT of them.

But what’s the actual reason?

Reason

By doing some googling, you can pretty quickly find out what this error is actually complaining about. It is a parsing error – so Azure DevOps didn’t even try to actually execute your script. It never got that far!

In my particular case, I was cursed by Visual Studio Code’s cool autocomplete, where it added extra double-quotes for me. Unfortunately, inside PowerShell tasks in YAML files, this script is not validated. Not even for syntax. So the addition went unnoticed.

Okay. But how does that help us validate the pipelines and find what the issue might be in our particular cases?

Well, read on!

Solution

The solution is to verify your script parses correctly. It’s not easy to do inside a YAML file, but there’s a workaround. Well, there’s always a workaround, isn’t there?

Let’s see how to do that easily!

Time needed: 5 minutes.

How to validate PowerShell tasks in YAML files?

Find the PowerShell tasks in the offending Job or Stage
You’ll need to find the PowerShell task(s) that are giving you trouble. Navigate to the failing step(s) in Azure DevOps to figure out which pipeline stage, job and task/step you need to modify.
Extract the PowerShell script contents
Copy-paste the script step contents from the YAML file to a new file.

Change the Language Mode of the file
Change the file’s “Language Mode” by clicking this in the bottom toolbar.
Set the Language Mode to “PowerShell”
You can set the Language Mode like shown below:
Observe the beautiful syntax errors!
Now you should get those useful squiggly lines below something! It might not be exactly the right place – in my example below, the first arrow shows a double quote (exactly what caused me this issue!), but the latter arrow shows where the squigglies appear. Still, it’s an improvement!

Okay, I know, I know – it’s a workaround at best. But those are what I commonly share, so… 😅

If you find a nicer way to do this, post it in the comments -section below!

Author

Recent Posts

Antti K. Koskela

Developer / Speaker / Consultant at Koskila / Precio Fishbone / Norppandalotti Software Co / Alter - Experience Ideas Ltd

Antti Koskela is a proud digital native nomadic millennial full stack developer (is that enough funny buzzwords? That's definitely enough funny buzzwords!), who works as Solutions Architect for Precio Fishbone, building delightful Digital Workplaces.

He's been a developer from 2004 (starting with PHP and Java), and he's been working on .NET projects, Azure, Office 365, SharePoint and a lot of other stuff. He's also Microsoft MVP for Office Development.

This is his personal professional (e.g. professional, but definitely personal) blog.

Latest posts by Antti K. Koskela (see all)