Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

6/14/2024 PM Publish #11192

Merged
merged 3 commits into from
Jun 14, 2024
Merged

6/14/2024 PM Publish #11192

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
887585a
Add note about the interactive nature of Enter-PSSession (#11189)
sdwheeler Jun 14, 2024
ae839fd
Improve wording to allow for better translations (#11190)
sdwheeler Jun 14, 2024
31d3f5f
fix typo and add clarification (#11191)
sdwheeler Jun 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions reference/5.1/Microsoft.PowerShell.Core/About/about_Regular_Expressions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Describes regular expressions in PowerShell.
Locale: en-US
ms.date: 04/17/2024
ms.date: 06/14/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_regular_expressions?view=powershell-5.1&WT.mc_id=ps-gethelp
schema: 2.0.0
title: about Regular Expressions
Expand All @@ -14,8 +14,8 @@ Describes regular expressions in PowerShell.
## Long description

> [!NOTE]
> This article will show you the syntax and methods for using regular
> expressions in PowerShell, not all syntax is discussed. For a more complete
> This article shows the syntax and methods for using regular expressions in
> PowerShell. It doesn't cover all possible expressions. For a more complete
> reference, see the [Regular Expression Language - Quick Reference][03].

A regular expression is a pattern used to match text. It can be made up of
Expand Down Expand Up @@ -193,9 +193,9 @@ characters.
```

> [!NOTE]
> When defining a regex containing an `$` anchor, be sure to enclose the regex
> using single quotes (`'`) instead of double quotes (`"`) or PowerShell will
> expand the expression as a variable.
> When defining a regex containing an anchor (`$` ), you should enclose the
> regex in single quotes (`'`). If you use double quotes (`"`), PowerShell
> interprets the string as an expandable variable expression.

When using anchors in PowerShell, you should understand the difference between
**Singleline** and **Multiline** regular expression options.
Expand Down Expand Up @@ -273,7 +273,7 @@ True
```

Use the `$Matches` **Hashtable** automatic variable to retrieve captured text.
The text representing the entire match is stored at key `0`. It is important to
The text representing the entire match is stored at key `0`. It's important to
note that the `$Matches` hashtable contains only the first occurrence of any
matching pattern.

Expand Down
43 changes: 24 additions & 19 deletions reference/5.1/Microsoft.PowerShell.Core/Enter-PSSession.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: System.Management.Automation.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Core
ms.date: 12/09/2022
ms.date: 06/14/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/enter-pssession?view=powershell-5.1&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Enter-PSSession
Expand Down Expand Up @@ -89,6 +89,11 @@ interactive session. However, you cannot use the `Disconnect-PSSession`, `Connec
To end the interactive session and disconnect from the remote computer, use the `Exit-PSSession`
cmdlet, or type `exit`.

> [!IMPORTANT]
> `Enter-PSSession` is designed to substitute the current interactive session with a new interactive
> remote session. You shouldn't call it from within a function or script or by passing it as a
> command to the `powershell.exe` executable.

## EXAMPLES

### Example 1: Start an interactive session
Expand Down Expand Up @@ -316,17 +321,17 @@ Accept wildcard characters: False

### -ConfigurationName

Specifies the session configuration that is used for the interactive session.
Specifies the session configuration that's used for the interactive session.

Enter a configuration name or the fully qualified resource URI for a session configuration. If you
specify only the configuration name, the following schema URI is prepended:
`http://schemas.microsoft.com/powershell`.

The session configuration for a session is located on the remote computer. If the specified session
configuration does not exist on the remote computer, the command fails.
configuration doesn't exist on the remote computer, the command fails.

The default value is the value of the `$PSSessionConfigurationName` preference variable on the local
computer. If this preference variable is not set, the default is Microsoft.PowerShell. For more
computer. If this preference variable isn't set, the default is Microsoft.PowerShell. For more
information, see [about_Preference_Variables](About/about_Preference_Variables.md).

```yaml
Expand All @@ -352,11 +357,11 @@ The default value is as follows:

`http://localhost:5985/WSMAN`

If you do not specify a **ConnectionURI**, you can use the **UseSSL**, **ComputerName**, **Port**,
If you don't specify a **ConnectionURI**, you can use the **UseSSL**, **ComputerName**, **Port**,
and **ApplicationName** parameters to specify the **ConnectionURI** values.

Valid values for the Transport segment of the URI are HTTP and HTTPS. If you specify a connection
URI with a Transport segment, but do not specify a port, the session is created by using standards
URI with a Transport segment, but don't specify a port, the session is created by using standards
ports: 80 for HTTP and 443 for HTTPS. To use the default ports for PowerShell remoting, specify port
5985 for HTTP or 5986 for HTTPS.

Expand Down Expand Up @@ -520,7 +525,7 @@ Accept wildcard characters: False

### -Port

Specifies the network port on the remote computer that is used for this command. To connect to a
Specifies the network port on the remote computer that's used for this command. To connect to a
remote computer, the remote computer must be listening on the port that the connection uses. The
default ports are 5985, which is the WinRM port for HTTP, and 5986, which is the WinRM port for
HTTPS.
Expand All @@ -531,7 +536,7 @@ listen at that port. Use the following commands to configure the listener:
1. `winrm delete winrm/config/listener?Address=*+Transport=HTTP`
2. `winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}`

Do not use the **Port** parameter unless you must. The port setting in the command applies to all
Don't use the **Port** parameter unless you must. The port setting in the command applies to all
computers or sessions on which the command runs. An alternate port setting might prevent the command
from running on all computers.

Expand Down Expand Up @@ -565,9 +570,9 @@ Accept wildcard characters: False

### -Session

Specifies a Windows PowerShell session (**PSSession**) to use for the interactive session. This
parameter takes a session object. You can also use the **Name**, **InstanceID**, or **ID**
parameters to specify a **PSSession**.
Specifies a PowerShell session (**PSSession**) to use for the interactive session. This parameter
takes a session object. You can also use the **Name**, **InstanceID**, or **ID** parameters to
specify a **PSSession**.

Enter a variable that contains a session object or a command that creates or gets a session object,
such as a `New-PSSession` or `Get-PSSession` command. You can also pipe a session object to
Expand Down Expand Up @@ -596,11 +601,11 @@ by using the `New-PSSessionOption` cmdlet, or a hash table in which the keys are
names and the values are session option values.

The default values for the options are determined by the value of the `$PSSessionOption` preference
variable, if it is set. Otherwise, the default values are established by options set in the session
variable, if it's set. Otherwise, the default values are established by options set in the session
configuration.

The session option values take precedence over default values for sessions set in the
`$PSSessionOption` preference variable and in the session configuration. However, they do not take
`$PSSessionOption` preference variable and in the session configuration. However, they don't take
precedence over maximum values, quotas or limits set in the session configuration.

For a description of the session options, including the default values, see `New-PSSessionOption`.
Expand All @@ -623,13 +628,13 @@ Accept wildcard characters: False
### -UseSSL

Indicates that this cmdlet uses the Secure Sockets Layer (SSL) protocol to establish a connection to
the remote computer. By default, SSL is not used.
the remote computer. By default, SSL isn't used.

WS-Management encrypts all Windows PowerShell content transmitted over the network. The **UseSSL**
parameter is an additional protection that sends the data across an HTTPS connection instead of an
HTTP connection.
WS-Management encrypts all PowerShell content transmitted over the network. The **UseSSL** parameter
is an additional protection that sends the data across an HTTPS connection instead of an HTTP
connection.

If you use this parameter, but SSL is not available on the port that is used for the command, the
If you use this parameter, but SSL isn't available on the port that's used for the command, the
command fails.

```yaml
Expand Down Expand Up @@ -717,7 +722,7 @@ to change the command prompt, run before the remote prompt is displayed.
find the local UI culture, use the `$UICulture` automatic variable.

`Enter-PSSession` requires the `Get-Command`, `Out-Default`, and `Exit-PSSession` cmdlets. If these
cmdlets are not included in the session configuration on the remote computer, the `Enter-PSSession`
cmdlets aren't included in the session configuration on the remote computer, the `Enter-PSSession`
commands fails.

Unlike `Invoke-Command`, which parses and interprets the commands before it sends them to the remote
Expand Down
14 changes: 7 additions & 7 deletions reference/7.2/Microsoft.PowerShell.Core/About/about_Regular_Expressions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Describes regular expressions in PowerShell.
Locale: en-US
ms.date: 04/17/2024
ms.date: 06/14/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_regular_expressions?view=powershell-7.2&WT.mc_id=ps-gethelp
schema: 2.0.0
title: about Regular Expressions
Expand All @@ -14,8 +14,8 @@ Describes regular expressions in PowerShell.
## Long description

> [!NOTE]
> This article will show you the syntax and methods for using regular
> expressions in PowerShell, not all syntax is discussed. For a more complete
> This article shows the syntax and methods for using regular expressions in
> PowerShell. It doesn't cover all possible expressions. For a more complete
> reference, see the [Regular Expression Language - Quick Reference][03].

A regular expression is a pattern used to match text. It can be made up of
Expand Down Expand Up @@ -193,9 +193,9 @@ characters.
```

> [!NOTE]
> When defining a regex containing an `$` anchor, be sure to enclose the regex
> using single quotes (`'`) instead of double quotes (`"`) or PowerShell will
> expand the expression as a variable.
> When defining a regex containing an anchor (`$` ), you should enclose the
> regex in single quotes (`'`). If you use double quotes (`"`), PowerShell
> interprets the string as an expandable variable expression.

When using anchors in PowerShell, you should understand the difference between
**Singleline** and **Multiline** regular expression options.
Expand Down Expand Up @@ -273,7 +273,7 @@ True
```

Use the `$Matches` **Hashtable** automatic variable to retrieve captured text.
The text representing the entire match is stored at key `0`. It is important to
The text representing the entire match is stored at key `0`. It's important to
note that the `$Matches` hashtable contains only the first occurrence of any
matching pattern.

Expand Down
Loading
Loading