Updates from: 05/04/2022 01:14:46
Service Microsoft Docs article Related commit history on GitHub Change details
Microsoft.PowerShell.Core About Parsing (5.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/5.1/Microsoft.PowerShell.Core/About/about_Parsing.md
icacls X:\VMS /grant Dom\HVAdmin:`(CI`)`(OI`)F
### The stop-parsing token Beginning in PowerShell 3.0, you can use the stop-parsing token (`--%`) to
-stop PowerShell from interpreting input asPowerShell commands or expressions.
+stop PowerShell from interpreting input as PowerShell commands or expressions.
> [!NOTE] > The stop-parsing token is only intended for use on Windows platforms.
Microsoft.PowerShell.Core About Quoting Rules (5.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/5.1/Microsoft.PowerShell.Core/About/about_Quoting_Rules.md
--- description: Describes rules for using single and double quotation marks in PowerShell. Locale: en-US Previously updated : 04/26/2022 Last updated : 05/03/2022 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_quoting_rules?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 Title: about Quoting Rules
Use a quotation mark (`") to begin a string.
The quotation rules for here-strings are slightly different.
-A here-string is a single-quoted or double-quoted string in which quotation
-marks are interpreted literally. A here-string can span multiple lines. All the
-lines in a here-string are interpreted as strings even though they are not
-enclosed in quotation marks.
+A here-string is a single-quoted or double-quoted string surrounded by at signs
+(`@`). Quotation marks within a here-string are interpreted literally.
+
+A here-string:
+
+- spans multiple lines
+- begins with the opening mark followed by a newline
+- ends with a newline followed by the closing mark
+- includes every line between the opening and closing marks as part of a single
+ string
Like regular strings, variables are replaced by their values in double-quoted here-strings. In single-quoted here-strings, variables are not replaced by
You can use here-strings for any text, but they are particularly useful for
the following kinds of text: - Text that contains literal quotation marks-- Multiple lines of text, such as the text in an HTML or XML
+- Multiple lines of text, such as the text in an HTML or XML block
- The Help text for a script or function document A here-string can have either of the following formats, where `<Enter>`
Single-quotes:
'@ ```
-In either format, the closing quotation mark must be the first character in
-the line.
+> [!NOTE]
+> The final newline character is part of the closing mark. It is not added to
+> the here-string.
-A here-string contains all the text between the two hidden characters. In the
-here-string, all quotation marks are interpreted literally. For example:
+A here-string contains all the text between the opening and closing marks. In
+the here-string, all quotation marks are interpreted literally. For example:
```powershell @"
Microsoft.PowerShell.Core About Parsing (7.0) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.0/Microsoft.PowerShell.Core/About/about_Parsing.md
icacls X:\VMS /grant Dom\HVAdmin:`(CI`)`(OI`)F
### The stop-parsing token Beginning in PowerShell 3.0, you can use the stop-parsing token (`--%`) to
-stop PowerShell from interpreting input asPowerShell commands or expressions.
+stop PowerShell from interpreting input as PowerShell commands or expressions.
> [!NOTE] > The stop-parsing token is only intended for use on Windows platforms.
Microsoft.PowerShell.Core About Quoting Rules (7.0) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.0/Microsoft.PowerShell.Core/About/about_Quoting_Rules.md
--- description: Describes rules for using single and double quotation marks in PowerShell. Locale: en-US Previously updated : 04/26/2022 Last updated : 05/03/2022 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_quoting_rules?view=powershell-7&WT.mc_id=ps-gethelp schema: 2.0.0 Title: about Quoting Rules
Use a quotation mark (`") to begin a string.
The quotation rules for here-strings are slightly different.
-A here-string is a single-quoted or double-quoted string in which quotation
-marks are interpreted literally. A here-string can span multiple lines. All the
-lines in a here-string are interpreted as strings even though they are not
-enclosed in quotation marks.
+A here-string is a single-quoted or double-quoted string surrounded by at signs
+(`@`). Quotation marks within a here-string are interpreted literally.
+
+A here-string:
+
+- spans multiple lines
+- begins with the opening mark followed by a newline
+- ends with a newline followed by the closing mark
+- includes every line between the opening and closing marks as part of a single
+ string
Like regular strings, variables are replaced by their values in double-quoted here-strings. In single-quoted here-strings, variables are not replaced by
You can use here-strings for any text, but they are particularly useful for
the following kinds of text: - Text that contains literal quotation marks-- Multiple lines of text, such as the text in an HTML or XML
+- Multiple lines of text, such as the text in an HTML or XML block
- The Help text for a script or function document A here-string can have either of the following formats, where `<Enter>`
Single-quotes:
'@ ```
-In either format, the closing quotation mark must be the first character in
-the line.
+> [!NOTE]
+> The final newline character is part of the closing mark. It is not added to
+> the here-string.
-A here-string contains all the text between the two hidden characters. In the
-here-string, all quotation marks are interpreted literally. For example:
+A here-string contains all the text between the opening and closing marks. In
+the here-string, all quotation marks are interpreted literally. For example:
```powershell @"
Microsoft.PowerShell.Core About Parsing (7.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.1/Microsoft.PowerShell.Core/About/about_Parsing.md
icacls X:\VMS /grant Dom\HVAdmin:`(CI`)`(OI`)F
### The stop-parsing token Beginning in PowerShell 3.0, you can use the stop-parsing token (`--%`) to
-stop PowerShell from interpreting input asPowerShell commands or expressions.
+stop PowerShell from interpreting input as PowerShell commands or expressions.
> [!NOTE] > The stop-parsing token is only intended for use on Windows platforms.
Microsoft.PowerShell.Core About Quoting Rules (7.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.1/Microsoft.PowerShell.Core/About/about_Quoting_Rules.md
--- description: Describes rules for using single and double quotation marks in PowerShell. Locale: en-US Previously updated : 04/26/2022 Last updated : 05/03/2022 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_quoting_rules?view=powershell-7.1&WT.mc_id=ps-gethelp schema: 2.0.0 Title: about Quoting Rules
Use a quotation mark (`") to begin a string.
The quotation rules for here-strings are slightly different.
-A here-string is a single-quoted or double-quoted string in which quotation
-marks are interpreted literally. A here-string can span multiple lines. All the
-lines in a here-string are interpreted as strings even though they are not
-enclosed in quotation marks.
+A here-string is a single-quoted or double-quoted string surrounded by at signs
+(`@`). Quotation marks within a here-string are interpreted literally.
+
+A here-string:
+
+- spans multiple lines
+- begins with the opening mark followed by a newline
+- ends with a newline followed by the closing mark
+- includes every line between the opening and closing marks as part of a single
+ string
Like regular strings, variables are replaced by their values in double-quoted here-strings. In single-quoted here-strings, variables are not replaced by
You can use here-strings for any text, but they are particularly useful for
the following kinds of text: - Text that contains literal quotation marks-- Multiple lines of text, such as the text in an HTML or XML
+- Multiple lines of text, such as the text in an HTML or XML block
- The Help text for a script or function document A here-string can have either of the following formats, where `<Enter>`
Single-quotes:
'@ ```
-In either format, the closing quotation mark must be the first character in
-the line.
+> [!NOTE]
+> The final newline character is part of the closing mark. It is not added to
+> the here-string.
-A here-string contains all the text between the two hidden characters. In the
-here-string, all quotation marks are interpreted literally. For example:
+A here-string contains all the text between the opening and closing marks. In
+the here-string, all quotation marks are interpreted literally. For example:
```powershell @"
Microsoft.PowerShell.Core About Parsing (7.2) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.2/Microsoft.PowerShell.Core/About/about_Parsing.md
icacls X:\VMS /grant Dom\HVAdmin:`(CI`)`(OI`)F
### The stop-parsing token Beginning in PowerShell 3.0, you can use the stop-parsing token (`--%`) to
-stop PowerShell from interpreting input asPowerShell commands or expressions.
+stop PowerShell from interpreting input as PowerShell commands or expressions.
> [!NOTE] > The stop-parsing token is only intended for use on Windows platforms.
Microsoft.PowerShell.Core About Quoting Rules (7.2) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.2/Microsoft.PowerShell.Core/About/about_Quoting_Rules.md
--- description: Describes rules for using single and double quotation marks in PowerShell. Locale: en-US Previously updated : 04/26/2022 Last updated : 05/03/2022 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_quoting_rules?view=powershell-7.2&WT.mc_id=ps-gethelp schema: 2.0.0 Title: about Quoting Rules
Use a quotation mark (`") to begin a string.
The quotation rules for here-strings are slightly different.
-A here-string is a single-quoted or double-quoted string in which quotation
-marks are interpreted literally. A here-string can span multiple lines. All the
-lines in a here-string are interpreted as strings even though they are not
-enclosed in quotation marks.
+A here-string is a single-quoted or double-quoted string surrounded by at signs
+(`@`). Quotation marks within a here-string are interpreted literally.
+
+A here-string:
+
+- spans multiple lines
+- begins with the opening mark followed by a newline
+- ends with a newline followed by the closing mark
+- includes every line between the opening and closing marks as part of a single
+ string
Like regular strings, variables are replaced by their values in double-quoted here-strings. In single-quoted here-strings, variables are not replaced by
You can use here-strings for any text, but they are particularly useful for
the following kinds of text: - Text that contains literal quotation marks-- Multiple lines of text, such as the text in an HTML or XML
+- Multiple lines of text, such as the text in an HTML or XML block
- The Help text for a script or function document A here-string can have either of the following formats, where `<Enter>`
Single-quotes:
'@ ```
-In either format, the closing quotation mark must be the first character in
-the line.
+> [!NOTE]
+> The final newline character is part of the closing mark. It is not added to
+> the here-string.
-A here-string contains all the text between the two hidden characters. In the
-here-string, all quotation marks are interpreted literally. For example:
+A here-string contains all the text between the opening and closing marks. In
+the here-string, all quotation marks are interpreted literally. For example:
```powershell @"
Microsoft.PowerShell.Core About Parsing (7.3) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.3/Microsoft.PowerShell.Core/About/about_Parsing.md
icacls X:\VMS /grant Dom\HVAdmin:`(CI`)`(OI`)F
### The stop-parsing token Beginning in PowerShell 3.0, you can use the stop-parsing token (`--%`) to
-stop PowerShell from interpreting input asPowerShell commands or expressions.
+stop PowerShell from interpreting input as PowerShell commands or expressions.
> [!NOTE] > The stop-parsing token is only intended for use on Windows platforms.
Microsoft.PowerShell.Core About Quoting Rules (7.3) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.3/Microsoft.PowerShell.Core/About/about_Quoting_Rules.md
--- description: Describes rules for using single and double quotation marks in PowerShell. Locale: en-US Previously updated : 04/26/2022 Last updated : 05/03/2022 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_quoting_rules?view=powershell-7.3&WT.mc_id=ps-gethelp schema: 2.0.0 Title: about Quoting Rules
Use a quotation mark (`") to begin a string.
The quotation rules for here-strings are slightly different.
-A here-string is a single-quoted or double-quoted string in which quotation
-marks are interpreted literally. A here-string can span multiple lines. All the
-lines in a here-string are interpreted as strings even though they are not
-enclosed in quotation marks.
+A here-string is a single-quoted or double-quoted string surrounded by at signs
+(`@`). Quotation marks within a here-string are interpreted literally.
+
+A here-string:
+
+- spans multiple lines
+- begins with the opening mark followed by a newline
+- ends with a newline followed by the closing mark
+- includes every line between the opening and closing marks as part of a single
+ string
Like regular strings, variables are replaced by their values in double-quoted here-strings. In single-quoted here-strings, variables are not replaced by
You can use here-strings for any text, but they are particularly useful for
the following kinds of text: - Text that contains literal quotation marks-- Multiple lines of text, such as the text in an HTML or XML
+- Multiple lines of text, such as the text in an HTML or XML block
- The Help text for a script or function document A here-string can have either of the following formats, where `<Enter>`
Single-quotes:
'@ ```
-In either format, the closing quotation mark must be the first character in
-the line.
+> [!NOTE]
+> The final newline character is part of the closing mark. It is not added to
+> the here-string.
-A here-string contains all the text between the two hidden characters. In the
-here-string, all quotation marks are interpreted literally. For example:
+A here-string contains all the text between the opening and closing marks. In
+the here-string, all quotation marks are interpreted literally. For example:
```powershell @"
community 2022 Updates https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/community/2022-updates.md
--- description: List of changes to the PowerShell documentation for 2022 Previously updated : 04/01/2022 Last updated : 05/03/2022 Title: What's New in PowerShell-Docs for 2022 --- # What's new in PowerShell Docs for 2022
contributions from the community.
Help us make the documentation better for you. Read the [Contributor's Guide][contrib] to learn how to get started.
+## 2022-April
+
+New content
+
+- No new content this month
+
+Content updates
+
+- Rewrote the install instructions for [PowerShellGet](/powershell/scripting/gallery/installing-psget)
+- Created separate article for
+ [Installing PowerShellGet on older Windows systems](/powershell/scripting/gallery/install-on-older-systems)
+
+Other projects
+
+- PowerShell + DevOps Summit April 25-28
+ - Gave presentation about contributing to Docs
+ - Lightning demo about argument completers
+ - Interview for the [PowerShell Podcast](https://powershellpodcast.podbean.com/e/contributing-to-powershell-made-easy-with-sean-wheeler/)
+
+### Top Community Contributors
+
+GitHub stats
+
+- 24 PRs merged (3 from Community)
+- 22 issues opened (17 from Community)
+- 21 issues closed (15 Community issues closed)
+
+The following people have contributed to PowerShell docs by submitting pull requests or filing
+issues. Thank you!
+
+| GitHub Id | PRs merged | Issues opened |
+| -------------- | :--------: | :-----------: |
+| Hrxn | 1 | |
+| kevinholtkamp | 1 | |
+| MikeyBronowski | 1 | |
+| tommymaynard | | 4 |
+ ## 2022-March New Content
community Hall Of Fame https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/community/hall-of-fame.md
--- description: List of the GitHub users that have the most contributions to the PowerShell-Doc project. Previously updated : 04/01/2022 Last updated : 05/03/2022 Title: Community contributor Hall of Fame --- # Community Contributor Hall of Fame
Pull Requests help us fix those issues and make the documentation better for eve
| PRs Merged | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | Grand Total | | --------------- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ----------: |
-| Community | 3 | 194 | 446 | 464 | 318 | 161 | 100 | 21 | 1707 |
+| Community | 3 | 194 | 446 | 464 | 318 | 161 | 100 | 24 | 1710 |
| matt9ucci | | | 157 | 80 | 30 | 1 | 6 | | 274 | | nschonni | | | | 14 | 138 | 10 | | | 162 | | kiazhi | | 25 | 79 | 12 | | | | | 116 |
GitHub issues help us identify errors and gaps in our documentation.
| Issues Opened | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | Grand Total | | ------------- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ----------: |
-| Community | 3 | 54 | 95 | 212 | 566 | 563 | 368 | 59 | 1920 |
+| Community | 3 | 54 | 95 | 212 | 566 | 563 | 368 | 71 | 1932 |
| mklement0 | | | 19 | 60 | 56 | 61 | 28 | | 224 | | iSazonov | | | 1 | 4 | 10 | 8 | 4 | | 27 | | jszabo98 | | | | 2 | 15 | 6 | 1 | | 24 |
GitHub issues help us identify errors and gaps in our documentation.
| trollyanov | | | | | | | 11 | | 11 | | rkeithhill | | | 1 | 2 | 2 | 2 | 3 | 1 | 11 | | JustinGrote | | | | 1 | 3 | 6 | 1 | | 11 |
-| vors | 1 | 6 | 2 | 1 | | | | | 10 |
| UberKluger | | | | | | 1 | 7 | 2 | 10 |
+| vors | 1 | 6 | 2 | 1 | | | | | 10 |
<!-- Link references --> [contrib]: contributing/overview.md