This is the built-in help made by Microsoft for the document 'about_Join', in PowerShell version 5 - as retrieved from
Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-24.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Describes how the join operator (-join) combines multiple strings into a
The join operator concatenates a set of strings into a single string. The
strings are appended to the resulting string in the order that they appear
in the command.
The following diagram shows the syntax for the join operator.
<String> -Join <Delimiter>
Specifies one or more strings to be joined.
Specifies one or more characters placed between the concatenated strings.
The default is no delimiter ("").
The unary join operator (-join <string>) has higher precedence than
a comma. As a result, if you submit a comma-separated list of strings to
the unary join operator, only the first string (before the first comma)
is submitted to the join operator.
To use the unary join operator, enclose the strings in parentheses, or
store the strings in a variable, and then submit the variable to join.
-join "a", "b", "c"
-join ("a", "b", "c")
$z = "a", "b", "c"
The following statement joins three strings:
-join ("Windows", "PowerShell", "2.0")
The following statement joins three strings delimited by a space:
"Windows", "PowerShell", "2.0" -join " "
Windows PowerShell 2.0
The following statements use a multiple-character delimiter to join
$a = "WIND", "SP", "ERSHELL"
$a -join "OW"
The following statement joins the lines in a here-string into
a single string. Because a here-string is one string, the lines in the
here-string must be split before they can be joined. You can use this
method to rejoin the strings in an XML file that has been saved in a
$a = @'
(-split $a) -join " "
a b c