为什么PowerShell

After reviewing this question again, I've added a second example that I hope will highlight where my confusion became amplified, namely there was one capture group accessed by its index (1), and the value I expected from the $filecontent was coincidentally also a 1.

This question indicates that a back tick can be used to address capture groups in a double quoted string when referencing other variables.

If you need to reference other variables in your replacement expression (as you may), you can use a double-quoted string and escape the capture dollars with a backtick

However, I'm seeing some interesting behavior that I can't explain.

replacing text in $filecontent using the capture group as specified in the linked question gives an incomplete result...

returns: 118.11.8 expected: 1.18.11.8

But adding a space between the $1 and $NewVersion gives a different yet equally unhelpful result..

returns: 1. 18.11.8 The captured dot appears here, but so does the undesirable space.

With this example, the results are somewhat similar, but it seems that the capture group is getting the wrong value all together.

Adding the space in the replacement string returns: 5. 18.11.8

So, what am I missing, or is there a better way to do this?

Judging from past experience, PetSerAl, who provided the crucial pointer in a comment on the question, won't be back to post an answer.

tl;dr

If you use -replace with a replacement operand that references capture groups and PowerShell variables, use syntax such as "`${}${}", where is the index of your capture group, and is the name of your PowerShell variable; note the ` before the first $:

If you neglect to use {...} to disambiguate the capture-group index, the replacement malfunctions, because the interpolated string value then effectively references a different index:-replace then sees [$12], which, due to referring to a nonexistent capture group with index 12, is left as-is:

It is tricky to mix PowerShell's string expansion (interpolation) with the syntax of the -replace operator, because it is easy to get confused:

In double-quoted ("...") strings, it is PowerShell's generic string expansion (string interpolation) feature that interprets $ chars first, where a $ prefix refers to (PowerShell) variables and, inside $(...), entire statements.

Whatever string is the result of that expansion is then interpreted by the -replace operator, where $-prefixed tokens refer to results of the regex-matching operation, as summarized in this answer.

Note that these layers of $ interpretation are entire unrelated and the fact that both use sigil $ is incidental.

Therefore:

If your replacement operand doesn't need string expansion, i.e., if there's no need to reference PowerShell variables or expressions, be sure to use a single-quoted string ('...'), so that PowerShell's string expansion doesn't come into play:

If you do need to involve string expansion:

Prefix $ chars. that should be passed through to -replace with `

To disambiguate references to capture groups, e.g., $1, enclose them in {...} - e.g., ${1}

If in doubt, output the replacement operand by itself in order to inspect what -replace will ultimately see.

To illustrate the latter point:

The problem was that -replace, after string expansion, saw [$12] as the replacement operand, and since there was no capture group with index 12, it was left as-is.

Enclosing the capture-group number in {...} solves the problem: