Updates from: 03/03/2021 04:04:04
Service Microsoft Docs article Related commit history on GitHub Change details
Microsoft.PowerShell.Utility Read Host (5.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/5.1/Microsoft.PowerShell.Utility/Read-Host.md
external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml
keywords: powershell,cmdlet Locale: en-US Module Name: Microsoft.PowerShell.Utility Previously updated : 06/09/2017 Last updated : 03/02/2021 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/read-host?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 Title: Read-Host
The `Read-Host` cmdlet reads a line of input from the console. You can use it to
input. Because you can save the input as a secure string, you can use this cmdlet to prompt users for secure data, such as passwords, as well as shared data.
+> [!NOTE]
+> `Read-Host` has a limit of 8190 characters it can accept as input from a user.
+ ## EXAMPLES ### Example 1: Save console input to a variable
Accept wildcard characters: False
### -Prompt
-Specifies the text of the prompt.
-Type a string.
-If the string includes spaces, enclose it in quotation marks.
-PowerShell appends a colon (`:`) to the text that you enter.
+Specifies the text of the prompt. Type a string. If the string includes spaces, enclose it in
+quotation marks. PowerShell appends a colon (`:`) to the text that you enter.
```yaml Type: System.Object
Microsoft.PowerShell.Core Foreach Object (7.0) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.0/Microsoft.PowerShell.Core/ForEach-Object.md
Output: 5
`Output: 3` is never written because the parallel scriptblock for that iteration was terminated.
-### Example 16: Passing variables in nested parallel script ScriptBlockSet
+### Example 17: Passing variables in nested parallel script ScriptBlockSet
You can create a variable outside a `Foreach-Object -Parallel` scoped scriptblock and use it inside the scriptblock with the `$using` keyword.
TestA
TestA ```
-You _cannot_ create a variable _inside_ a scoped scriptblock to be used in a nested foreach parallel
-scriptblock.
- ```powershell
+# You CANNOT create a variable inside a scoped scriptblock
+# to be used in a nested foreach parallel scriptblock.
$test1 = 'TestA' 1..2 | Foreach-Object -Parallel { $using:test1
Microsoft.PowerShell.Utility Read Host (7.0) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.0/Microsoft.PowerShell.Utility/Read-Host.md
external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml
keywords: powershell,cmdlet Locale: en-US Module Name: Microsoft.PowerShell.Utility Previously updated : 06/09/2017 Last updated : 03/02/2021 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/read-host?view=powershell-7&WT.mc_id=ps-gethelp schema: 2.0.0 Title: Read-Host
The `Read-Host` cmdlet reads a line of input from the console. You can use it to
input. Because you can save the input as a secure string, you can use this cmdlet to prompt users for secure data, such as passwords, as well as shared data.
+> [!NOTE]
+> `Read-Host` has a limit of 1022 characters it can accept as input from a user.
+ ## EXAMPLES ### Example 1: Save console input to a variable
Accept wildcard characters: False
### -Prompt
-Specifies the text of the prompt.
-Type a string.
-If the string includes spaces, enclose it in quotation marks.
-PowerShell appends a colon (`:`) to the text that you enter.
+Specifies the text of the prompt. Type a string. If the string includes spaces, enclose it in
+quotation marks. PowerShell appends a colon (`:`) to the text that you enter.
```yaml Type: System.Object
Microsoft.PowerShell.Core Foreach Object (7.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.1/Microsoft.PowerShell.Core/ForEach-Object.md
Output: 5
`Output: 3` is never written because the parallel scriptblock for that iteration was terminated.
-### Example 16: Passing variables in nested parallel script ScriptBlockSet
+### Example 17: Passing variables in nested parallel script ScriptBlockSet
You can create a variable outside a `Foreach-Object -Parallel` scoped scriptblock and use it inside the scriptblock with the `$using` keyword.
TestA
TestA ```
-You _cannot_ create a variable _inside_ a scoped scriptblock to be used in a nested foreach parallel
-scriptblock.
- ```powershell
+# You CANNOT create a variable inside a scoped scriptblock
+# to be used in a nested foreach parallel scriptblock.
$test1 = 'TestA' 1..2 | Foreach-Object -Parallel { $using:test1
state and retrieve data.
This parameter was introduced in PowerShell 7.0. ```yaml
-Type: SwitchParameter
+Type: System.Management.Automation.SwitchParameter
Parameter Sets: ParallelParameterSet Aliases:
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet. ```yaml
-Type: SwitchParameter
+Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All) Aliases: cf
Accept wildcard characters: False
Shows what would happen if the cmdlet runs. The cmdlet is not run. ```yaml
-Type: SwitchParameter
+Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All) Aliases: wi
Microsoft.PowerShell.Utility Read Host (7.1) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.1/Microsoft.PowerShell.Utility/Read-Host.md
external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml
keywords: powershell,cmdlet Locale: en-US Module Name: Microsoft.PowerShell.Utility Previously updated : 06/04/2020 Last updated : 03/02/2021 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/read-host?view=powershell-7.1&WT.mc_id=ps-gethelp schema: 2.0.0 Title: Read-Host
The `Read-Host` cmdlet reads a line of input from the console. You can use it to
input. Because you can save the input as a secure string, you can use this cmdlet to prompt users for secure data, such as passwords, as well as shared data.
+> [!NOTE]
+> `Read-Host` has a limit of 1022 characters it can accept as input from a user.
+ ## EXAMPLES ### Example 1: Save console input to a variable
Accept wildcard characters: False
### -Prompt
-Specifies the text of the prompt.
-Type a string.
-If the string includes spaces, enclose it in quotation marks.
-PowerShell appends a colon (`:`) to the text that you enter.
+Specifies the text of the prompt. Type a string. If the string includes spaces, enclose it in
+quotation marks. PowerShell appends a colon (`:`) to the text that you enter.
```yaml Type: System.Object
Microsoft.PowerShell.Utility Read Host (7.2) https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/7.2/Microsoft.PowerShell.Utility/Read-Host.md
external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Utility Previously updated : 06/04/2020 Last updated : 03/02/2021 online version: https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/read-host?view=powershell-7.2&WT.mc_id=ps-gethelp schema: 2.0.0 Title: Read-Host
The `Read-Host` cmdlet reads a line of input from the console. You can use it to
input. Because you can save the input as a secure string, you can use this cmdlet to prompt users for secure data, such as passwords, as well as shared data.
+> [!NOTE]
+> `Read-Host` has a limit of 1022 characters it can accept as input from a user.
+ ## EXAMPLES ### Example 1: Save console input to a variable
Accept wildcard characters: False
### -Prompt
-Specifies the text of the prompt.
-Type a string.
-If the string includes spaces, enclose it in quotation marks.
-PowerShell appends a colon (`:`) to the text that you enter.
+Specifies the text of the prompt. Type a string. If the string includes spaces, enclose it in
+quotation marks. PowerShell appends a colon (`:`) to the text that you enter.
```yaml Type: System.Object
community 2020 Updates https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/community/2020-updates.md
description: List of changes to the PowerShell documentation for Q4 of 2020
Last updated 01/05/2021 ---
-# What's new in PowerShell Docs for 2020-Q4
+# What's new in PowerShell Docs for 2020
This article lists some of the major changes to docs during this previous month and celebrates the contributions from the community.
to get started.
[contrib]: contributing/overview.md <!-- --------------- -->
-## 2020-December Highlights
+## 2020-December
- Updated contributor guide - documented the `&preserve_view=true` query parameter for hyperlinks
issues. Thank you!
| Cwilson-dataselfcom | | 5 | | bobbybatatina | | 2 |
-## 2020-November Highlights
+## 2020-November
- PowerShell 7.1 GA Release - What's New in PowerShell 7.1
issues. Thank you!
| stephenrgentry | | 2 | | Vixb1122 | | 2 |
-## 2020-October Highlights
+## 2020-October
- New articles - [about_Character_Encoding](/powershell/module/microsoft.powershell.core/about/about_character_encoding)
issues. Thank you!
| mklement0 | | 3 | | Abdullah0820 | | 2 |
-## 2020-September Highlights
+## 2020-September
- Documentation maintenance - Updates for 7.1-preview content
issues. Thank you!
| mklement0 | | 13 | | setpeetrike | | 2 |
-## 2020-August Highlights
+## 2020-August
- New PowerShell documentation - [About_Calculated_Properties](/powershell/module/microsoft.powershell.core/about/about_calculated_properties)
issues. Thank you!
| joshSi | 1 | | | kmoad | 1 | |
-## 2020-July Highlights
+## 2020-July
- New PowerShell documentation - Resurrected old [ETS docs](/powershell/scripting/developer/ets/overview) - 7 articles added
issues. Thank you!
| sharpninja | | 2 | | XuHeng1021 | | 2 |
-## 2020-June Highlights
+## 2020-June
- New PowerShell documentation - Published new [PowerShell 101](../learn/ps101/00-introduction.md) content contributed by Mike F.
issues. Thank you!
| mklement0 | | 2 | | Sagatboy33 | | 4 |
-## 2020-May Highlights
+## 2020-May
- New PowerShell documentation - Created a new [Deep dives](../learn/deep-dives/overview.md) section containing content from
issues. Thank you!
| JustinGrote | | 2 | | peetrike | | 2 |
-## 2020-April Highlights
+## 2020-April
- New documents - PowerShell documentation
issues. Thank you!
## 2020-March
-### Highlights
+###
- New documents - The PowerShell Docs community pages
issues. Thank you!
## 2020-February
-### Highlights
+###
- New documents - [about_Parameter_Sets](/powershell/module/microsoft.powershell.core/about/about_parameter_sets)
issues. Thank you!
## 2020-January
-### Highlights
+###
- New documents - [about_Windows_PowerShell_Compatibility](/powershell/module/microsoft.powershell.core/about/about_Windows_PowerShell_Compatibility)
community 2021 Updates https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/community/2021-updates.md
--- Title: What's New in PowerShell Docs for 2020-Q1 description: List of changes to the PowerShell documentation for 2020-Q1 Previously updated : 02/01/2021 Last updated : 03/02/2021 ---
-# What's new in PowerShell Docs for 2021-Q1
+# What's new in PowerShell Docs for 2021
This article lists some of the major changes to docs during this previous month and celebrates the contributions from the community.
contributions from the community.
Help us make the documentation better for you. Read the [Contributor's Guide][contrib] to learn how to get started.
-## 2021-January
+## 2021-February
+
+- PowerShell 7.2-preview documentation updates
+- GitHub stats
+ - 40 PRs merged (12 from Community)
+ - 40 issues opened (30 from Community)
+ - 35 issues closed
+
+### Top Community Contributors
-### Highlights
+The following people have contributed to PowerShell docs by submitting pull requests or filing
+issues. Thank you!
+
+| GitHub Id | PRs merged | Issues opened |
+| --------------- | :--------: | :-----------: |
+| bbodenmiller | 1 | |
+| brianary | 1 | |
+| exchange12rocks | 1 | |
+| IvenBach | 1 | |
+| jamiepinheiro | 1 | |
+| jdoubleu | 1 | |
+| LogicalToolkit | 1 | |
+| matt9ucci | 1 | |
+| mihir-ajmera | 1 | |
+| revolter | 1 | |
+| secretGeek | 1 | |
+| springcomp | 1 | |
+| Ayanmullick | | 2 |
+
+## 2021-January
- PowerShell 7.2-preview documentation updates - GitHub stats - 44 PRs merged (14 from Community) - 46 issues opened (38 from Community)
- - 45 issues closed
+ - 35 issues closed
### Top Community Contributors
community Hall Of Fame https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/community/hall-of-fame.md
--- Title: Community contributor Hall of Fame description: List of the GitHub users that have the most contributions to the PowerShell-Doc project. Previously updated : 02/01/2021 Last updated : 03/02/2021 --- # Community Contributor Hall of Fame
Pull Requests help us fix those issues and make the documentation better for eve
| Docs PRs Merged | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | Grand Total | | --------------- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ----------: |
-| Community | 3 | 198 | 448 | 468 | 322 | 162 | 14 | 1615 |
-| matt9ucci | | | 157 | 80 | 30 | 1 | | 268 |
+| Community | 3 | 194 | 446 | 467 | 321 | 162 | 26 | 1619 |
+| matt9ucci | | | 157 | 80 | 30 | 1 | 1 | 269 |
| nschonni | | | | 14 | 138 | 10 | | 162 |
-| kiazhi | | 25 | 79 | 12 | | | | 116 |
-| alexandair | | 59 | 8 | 26 | 2 | 1 | | 96 |
+| kiazhi | | 25 | 78 | 12 | | | | 115 |
+| alexandair | | 57 | 7 | 26 | 2 | 1 | | 93 |
| doctordns | | 5 | 32 | 20 | 7 | 9 | | 73 | | sethvs | | | 1 | 44 | | 20 | | 65 | | yecril71pl | | | | | | 21 | | 21 | | Dan1el42 | | 20 | | | | | | 20 | | NReilingh | | 2 | | 13 | 3 | | | 18 | | it-praktyk | | | | 16 | 1 | | | 17 |
+| vors | | 15 | 1 | | | | | 16 |
| markekraus | | | 11 | 5 | | | | 16 | | kvprasoon | | 2 | 1 | 7 | 2 | 2 | | 14 |
+| skycommand | | | 1 | 3 | 3 | 6 | | 13 |
| purdo17 | | | | 13 | | | | 13 | | k-takai | | | | 5 | 1 | 7 | | 13 |
-| skycommand | | | 1 | 3 | 3 | 6 | | 13 |
+| exchange12rocks | | | 7 | 3 | | | 1 | 11 |
| PlagueHO | | 10 | | | 1 | | | 11 |
-| exchange12rocks | | | 7 | 3 | | | | 10 |
-| KirkMunro | | 1 | 1 | 2 | 6 | | | 10 |
## GitHub issues opened
GitHub issues help us identify errors and gaps in our documentation.
| Docs Issues Opened | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | Grand Total | | ------------------ | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ----------: |
-| Community | 3 | 54 | 95 | 213 | 575 | 584 | 38 | 1562 |
+| Community | 3 | 54 | 95 | 213 | 575 | 584 | 70 | 1594 |
| mklement0 | | | 19 | 60 | 56 | 61 | 2 | 198 | | jszabo98 | | | | 2 | 15 | 6 | | 23 | | iSazonov | | | 1 | 4 | 10 | 8 | | 23 |
GitHub issues help us identify errors and gaps in our documentation.
| juvtib | | | | | | 15 | | 15 | | alexandair | | 9 | 4 | 2 | | | | 15 | | vexx32 | | | | 3 | 11 | | | 14 |
-| vors | 1 | 6 | 2 | 1 | | | | 10 |
| JustinGrote | | | | 1 | 3 | 6 | | 10 | <!-- Link references -->
developer Approved Verbs For Windows Powershell Commands https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/developer/cmdlet/approved-verbs-for-windows-powershell-commands.md
--- Previously updated : 09/07/2018 Last updated : 03/01/2021 Title: Approved Verbs for PowerShell Commands description: Approved Verbs for PowerShell Commands
extract information contained within.
### Invoke vs. Start Use the `Invoke` verb to perform synchronous operations, such as
-running a command and waiting for it to end. Use the `Start` verb is used to begin asynchronous
+running a command and waiting for it to end. Use the `Start` verb to begin asynchronous
operations, such as starting an autonomous process. ### Ping vs. Test
learn Everything About Switch https://github.com/MicrosoftDocs/PowerShell-Docs/commits/staging/reference/docs-conceptual/learn/deep-dives/everything-about-switch.md
--- Title: Everything you ever wanted to know about the switch statement description: The switch statement in PowerShell offers features that aren't found in other languages. Previously updated : 05/23/2020 Last updated : 03/01/2021 --- # Everything you ever wanted to know about the switch statement
in the next section where this variable is used.
## Parameters
-A unique feature of the PowerShell `switch` is that it has a number of [switch parameters][] that
+A unique feature of the PowerShell `switch` is that it has a number of switch parameters that
change how it performs. ### -CaseSensitive
you learned something that you had not realized before.
[powershellexplained.com]: https://powershellexplained.com/ [@KevinMarquette]: https://twitter.com/KevinMarquette [switch]: /powershell/module/microsoft.powershell.core/about/about_switch
-[switch parameters]: https://www.powershellmagazine.com/2013/12/20/using-powershell-switch-vs-boolean-parameters-in-sma-runbooks/
[The many ways to use regex]: https://powershellexplained.com/2017-07-31-Powershell-regex-regular-expression [hashtables]: everything-about-hashtable.md