Skip to content

Commit fababe9

Browse files
committed
Format cleanup
1 parent 149e15c commit fababe9

File tree

1 file changed

+21
-18
lines changed

1 file changed

+21
-18
lines changed

reference/7.5/Microsoft.PowerShell.Core/About/about_Preference_Variables.md

Lines changed: 21 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,8 @@ Cmdlets and functions are assigned a risk of **High**, **Medium**, or **Low**.
119119
When the value of the `$ConfirmPreference` variable is less than or equal to
120120
the risk assigned to a cmdlet or function, PowerShell automatically prompts you
121121
for confirmation before running the cmdlet or function. For more information
122-
about assigning a risk to cmdlets or functions, see [about_Functions_CmdletBindingAttribute][66].
122+
about assigning a risk to cmdlets or functions, see
123+
[about_Functions_CmdletBindingAttribute][66].
123124

124125
If the value of the `$ConfirmPreference` variable is **None**, PowerShell never
125126
automatically prompts you before running a cmdlet or function.
@@ -167,11 +168,12 @@ Cmdlets and functions that might pose a risk to the system have a **Confirm**
167168
parameter that you can use to request or suppress confirmation for a single
168169
command.
169170

170-
Most cmdlets and functions keep the default value of **Medium** for **ConfirmImpact**.
171-
`$ConfirmPreference` is set to **High** by default. Therefore, it's rare that commands
172-
automatically prompt for confirmation when users don't specify the **Confirm** parameter.
173-
To extend automatic confirmation prompting to more cmdlets and functions, set the value
174-
of `$ConfirmPreference` to **Medium** or **Low**.
171+
Most cmdlets and functions keep the default value of **Medium** for
172+
**ConfirmImpact**. `$ConfirmPreference` is set to **High** by default.
173+
Therefore, it's rare that commands automatically prompt for confirmation when
174+
users don't specify the **Confirm** parameter. To extend automatic confirmation
175+
prompting to more cmdlets and functions, set the value of `$ConfirmPreference`
176+
to **Medium** or **Low**.
175177

176178
### Examples
177179

@@ -394,8 +396,8 @@ The valid values are as follows:
394396
- **SilentlyContinue**: No effect. The error message isn't displayed and
395397
execution continues without interruption.
396398
- **Stop**: Displays the error message and stops executing. In addition to the
397-
error generated, the **Stop** value generates an ActionPreferenceStopException
398-
object to the error stream.
399+
error generated, the **Stop** value generates an
400+
ActionPreferenceStopException object to the error stream.
399401
- **Suspend**: Automatically suspends a workflow job to allow for further
400402
investigation. After investigation, the workflow can be resumed. The
401403
**Suspend** value is intended for per-command use, not for use as saved
@@ -978,25 +980,26 @@ The valid values are as follows:
978980
Determines the character encoding method that PowerShell uses when it reads
979981
text from an external application on the stdout or stderr pipe.
980982

981-
For example, if an application writes text in an encoding that is different
983+
For example, if an application writes text in an encoding that's different
982984
from `[Console]::OutputEncoding`, you can set this variable to the encoding
983-
that is used by that application.
985+
that's used by that application.
984986

985987
> [!NOTE]
986988
> This only applies when PowerShell is set to capture the stdout or stderr of
987-
> the application being invoked, for example it is being saved into a
989+
> the application being invoked, for example it's being saved into a
988990
> variable or piped into a PowerShell function.
989991
990992
Unlike `[Console]::OutputEncoding`, `$PSApplicationOutputEncoding` is scoped
991-
and will not change a process wide setting allowing it to be used in code
992-
running in parallel scriptblock.
993+
and won't change a process wide setting allowing it to be used in code running
994+
in parallel scriptblock.
993995

994996
Well known examples of applications that use a fixed encoding rather than
995997
`[Console]::OutputEncoding` are:
996998

997-
+ `wsl.exe` - Always uses [**UnicodeEncoding**][63]
998-
+ `winget.exe` - Always uses [**UTF8Encoding**][66]
999-
+ `python.exe` - Uses the Windows locale encoding or [**UTF8Encoding**][66] if the UTF-8 flags are set
999+
- `wsl.exe` - Always uses [**UnicodeEncoding**][63]
1000+
- `winget.exe` - Always uses [**UTF8Encoding**][66]
1001+
- `python.exe` - Uses the Windows locale encoding or [**UTF8Encoding**][66] if
1002+
the UTF-8 flags are set
10001003

10011004
The valid values are as follows: Objects derived from an Encoding class, such
10021005
as [**ASCIIEncoding**][62], [**UTF7Encoding**][65], [**UTF8Encoding**][66],
@@ -1324,8 +1327,8 @@ The valid values are as follows:
13241327
- **Inquire**: Displays the verbose message and then displays a prompt that
13251328
asks you whether you want to continue.
13261329
- **Continue**: Displays the verbose message and then continues with execution.
1327-
- **SilentlyContinue**: (Default) Doesn't display the verbose message. Continues
1328-
executing.
1330+
- **SilentlyContinue**: (Default) Doesn't display the verbose message.
1331+
Continues executing.
13291332

13301333
You can use the **Verbose** common parameter of a cmdlet to display or hide the
13311334
verbose messages for a specific command. For more information, see

0 commit comments

Comments
 (0)