Skip to content

Commit 0705903

Browse files
committed
Updates to EOP and SCC Powershell connection instructions
Added troubleshooting bullet about SNAT issues per VSO:2316204
1 parent a5c94b6 commit 0705903

File tree

3 files changed

+25
-9
lines changed

3 files changed

+25
-9
lines changed

exchange/docs-conceptual/exchange-eop/connect-to-exchange-online-protection-powershell.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Connect to Exchange Online Protection PowerShell"
33
ms.author: chrisda
44
author: chrisda
55
manager: serdars
6-
ms.date: 7/10/2017
6+
ms.date: 5/9/2018
77
ms.audience: Admin
88
ms.topic: article
99
ms.service: eop
@@ -53,15 +53,15 @@ Exchange Online Protection PowerShell allows you to manage your Exchange Online
5353
5454
## Connect to Exchange Online Protection
5555

56-
1. On your local computer, open Windows PowerShell and run the following command.
56+
1. On your local computer, open Windows PowerShell and run the following command:
5757

5858
```
5959
$UserCredential = Get-Credential
6060
```
6161

6262
In the **Windows PowerShell Credential Request** dialog box, type your work or school account and password, and then click **OK**.
6363

64-
2. Run the following command.
64+
2. Run the following command:
6565

6666
```
6767
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.protection.outlook.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
@@ -73,7 +73,7 @@ Exchange Online Protection PowerShell allows you to manage your Exchange Online
7373
7474
- For Exchange Online Protection subscriptions that are Exchange Enterprise CAL with Services (includes data loss prevention (DLP) and reporting using web services), use the _ConnectionUri_ value: `https://outlook.office365.com/powershell-liveid/`
7575
76-
3. Run the following command.
76+
3. Run the following command:
7777
7878
```
7979
Import-PSSession $Session
@@ -97,7 +97,13 @@ If you receive errors, check the following requirements:
9797
- To help prevent denial-of-service (DoS) attacks, you're limited to three open remote PowerShell connections to your Exchange Online Protection organization.
9898
9999
- TCP port 80 traffic needs to be open between your local computer and Office 365. It's probably open, but it's something to consider if your organization has a restrictive Internet access policy.
100-
100+
101+
- The **New-PSSession** command (Step 2) might fail to connect if your client IP address changes during the connection request. This can happen if your organization uses a source network address translation (SNAT) pool that contains multiple IP addresses. The connection error looks like this:
102+
103+
`The request for the Windows Remote Shell with ShellId <ID> failed because the shell was not found on the server. Possible causes are: the specified ShellId is incorrect or the shell no longer exists on the server. Provide the correct ShellId or create a new shell and retry the operation.`
104+
105+
To fix the issue, use an SNAT pool that contains a single IP address, or force the use of a specific IP address for connections to the Exchange Online Protection PowerShell endpoint.
106+
101107
## See also
102108
103109
The cmdlets that you use in this topic are Windows PowerShell cmdlets. For more information about these cmdlets, see the following topics.

exchange/docs-conceptual/office-365-scc/connect-to-scc-powershell/connect-to-scc-powershell.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Connect to Office 365 Security &amp; Compliance Center PowerShell"
33
ms.author: chrisda
44
author: chrisda
55
manager: serdars
6-
ms.date: 12/13/2017
6+
ms.date: 5/9/2018
77
ms.audience: Admin
88
ms.topic: article
99
ms.service: o365-security-and-compliance
@@ -72,7 +72,7 @@ For more information about the Security &amp; Compliance Center, see [Office 365
7272
7373
**Note**: For Office 365 Germany, use the _ConnectionUri_ value: `https://ps.compliance.protection.outlook.de/powershell-liveid/`
7474
75-
3. Run the following command.
75+
3. Run the following command:
7676
7777
```
7878
Import-PSSession $Session
@@ -98,7 +98,13 @@ If you receive errors, check the following requirements:
9898
- To help prevent denial-of-service (DoS) attacks, you're limited to three open remote PowerShell connections to the Security &amp; Compliance Center.
9999
100100
- TCP port 80 traffic needs to be open between your local computer and Office 365. It's probably open, but it's something to consider if your organization has a restrictive Internet access policy.
101-
101+
102+
- The **New-PSSession** command (Step 2) might fail to connect if your client IP address changes during the connection request. This can happen if your organization uses a source network address translation (SNAT) pool that contains multiple IP addresses. The connection error looks like this:
103+
104+
`The request for the Windows Remote Shell with ShellId <ID> failed because the shell was not found on the server. Possible causes are: the specified ShellId is incorrect or the shell no longer exists on the server. Provide the correct ShellId or create a new shell and retry the operation.`
105+
106+
To fix the issue, use an SNAT pool that contains a single IP address, or force the use of a specific IP address for connections to the Security & Compliance PowerShell endpoint.
107+
102108
## See also
103109
104110
The cmdlets that you use in this topic are Windows PowerShell cmdlets. For more information about these cmdlets, see the following topics.

exchange/docs-conceptual/office-365-scc/connect-to-scc-powershell/mfa-connect-to-scc-powershell.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Connect to Office 365 Security &amp; Compliance Center PowerShell using multi-factor authentication"
33
ms.author: chrisda
44
author: chrisda
5-
ms.date: 12/13/2017
5+
ms.date: 5/9/2018
66
ms.audience: Admin
77
ms.topic: article
88
ms.service: o365-security-and-compliance
@@ -106,4 +106,8 @@ If you receive errors, check the following requirements:
106106
107107
- TCP port 80 traffic needs to be open between your local computer and Office 365. It's probably open, but it's something to consider if your organization has a restrictive Internet access policy.
108108
109+
- The **Connect-IPPSSession** command (Step 2) might fail to connect if your client IP address changes during the connection request. This can happen if your organization uses a source network address translation (SNAT) pool that contains multiple IP addresses. The connection error looks like this:
109110
111+
`The request for the Windows Remote Shell with ShellId <ID> failed because the shell was not found on the server. Possible causes are: the specified ShellId is incorrect or the shell no longer exists on the server. Provide the correct ShellId or create a new shell and retry the operation.`
112+
113+
To fix the issue, use an SNAT pool that contains a single IP address, or force the use of a specific IP address for connections to the Security & Compliance PowerShell endpoint.

0 commit comments

Comments
 (0)