Skip to content

Commit b487d84

Browse files
committed
Updates to connection instruction topics
1 parent 519301c commit b487d84

File tree

5 files changed

+35
-79
lines changed

5 files changed

+35
-79
lines changed

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

Lines changed: 6 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -29,20 +29,7 @@ To use the older Exchange Online Remote PowerShell Module to connect to Exchange
2929

3030
- The requirements for installing and using the EXO V2 module are described in [Install and maintain the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module).
3131

32-
- The required _ConnectionUri_ and _AzureADAuthorizationEndPointUri_ parameter values depend on the nature of your Microsoft 365 organization as described in the following table:
33-
34-
****
35-
36-
|Microsoft 365 offering|_ConnectionUri_ value|_AzureADAuthorizationEndPointUri_ value|
37-
|---|---|---|
38-
|Microsoft 365 or Microsoft 365 GCC|Not used|Not used|
39-
|Office 365 Germany|`https://outlook.office.de/PowerShell-LiveID`|`https://login.microsoftonline.de/common`|
40-
|Office 365 operated by 21Vianet|`https://partner.outlook.cn/PowerShell`|n/a|
41-
|Microsoft 365 GCC High|`https://outlook.office365.us/powershell-liveid`|`https://login.microsoftonline.us/common`|
42-
|Microsoft 365 DoD|`https://webmail.apps.mil/powershell-liveid`|`https://login.microsoftonline.us/common`|
43-
|
44-
45-
- The _DelegatedOrganization_ parameter specifies the customer organization that you want to manage as an authorized Microsoft Partner. For more information, see [Partners](https://docs.microsoft.com/office365/servicedescriptions/office-365-platform-service-description/partners).
32+
- If your organization is on-premises Exchange, and you have Exchange Enterprise CAL with Services licenses for EOP, your EOP PowerShell connection instructions are the same as Exchange Online PowerShell as described in this topic.
4633

4734
> [!TIP]
4835
> Having problems? Ask in the [Exchange Online](https://go.microsoft.com/fwlink/p/?linkId=267542) forum.
@@ -64,7 +51,8 @@ If you account uses multi-factor authentication, use the steps in this section.
6451
```
6552

6653
- _\<UPN\>_ is your account in user principal name format (for example, `[email protected]`).
67-
- The _ConnectionUri_ and _AzureADAuthorizationEndPointUrl_ values are described in the table in the [What do you need to know before you begin?](#what-do-you-need-to-know-before-you-begin) section.
54+
- The required _ConnectionUri_ and _AzureADAuthorizationEndPointUrl_ values depend on the nature of your Microsoft 365 organization. For more information, see the parameter descriptions in [Connect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
55+
- The _DelegatedOrganization_ parameter specifies the customer organization that you want to manage as an authorized Microsoft Partner. For more information, see [Partners](https://docs.microsoft.com/office365/servicedescriptions/office-365-platform-service-description/partners).
6856

6957
**This example connects to Exchange Online PowerShell in a Microsoft 365 or Microsoft 365 GCC organization**:
7058

@@ -93,7 +81,7 @@ If you account uses multi-factor authentication, use the steps in this section.
9381
**This example connects to Exchange Online PowerShell to manage another tenant**:
9482

9583
```powershell
96-
Connect-ExchangeOnline -UserPrincipalName chris@contoso.com -DelegatedOrganization adatum.onmicrosoft.com
84+
Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -DelegatedOrganization adatum.onmicrosoft.com
9785
```
9886

9987
For detailed syntax and parameter information, see [Connect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
@@ -129,7 +117,8 @@ If your account doesn't use multi-factor authentication, use the steps in this s
129117
Connect-ExchangeOnline -Credential $UserCredential = Get-Credential -ShowProgress $true [-ConnectionUri <URL>] [-DelegatedOrganization <String>]
130118
```
131119

132-
The _ConnectionUri_ values are described in the table in the [What do you need to know before you begin?](#what-do-you-need-to-know-before-you-begin) section.
120+
- The required _ConnectionUri_ value depends on the nature of your Microsoft 365 organization. For more information, see the parameter description in [Connect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
121+
- The _DelegatedOrganization_ parameter specifies the customer organization that you want to manage as an authorized Microsoft Partner. For more information, see [Partners](https://docs.microsoft.com/office365/servicedescriptions/office-365-platform-service-description/partners).
133122

134123
**Connect to Exchange Online PowerShell in a Microsoft 365 or Microsoft 365 GCC organization**:
135124

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

Lines changed: 11 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -25,20 +25,11 @@ To use the older, less secure remote PowerShell connection instructions that [wi
2525

2626
## What do you need to know before you begin?
2727

28-
- **The procedures in this topic are only for EOP organizations that don't have Exchange Online mailboxes** (for example, you have a standalone EOP subscription that protects your on-premises email environment). If you have a Microsoft 365 subscription includes Exchange Online mailboxes, you can't connect to Exchange Online Protection PowerShell. The same features are available in [Exchange Online PowerShell](exchange-online-powershell.md).
28+
- **The procedures in this topic are only for Microsoft 365 organizations that don't have Exchange Online mailboxes**. For example, you have a standalone EOP subscription that protects your on-premises email environment. If your Microsoft 365 subscription includes Exchange Online mailboxes, you can't connect to EOP PowerShell; instead, you [connect to Exchange Online PowerShell](connect-to-exchange-online-powershell.md).
2929

30-
- The requirements for installing and using the EXO V2 module are described in [Install and maintain the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module).
31-
32-
- The required cmdlet and _ConnectionUri_ and _AzureADAuthorizationEndPointUri_ parameter values depend on the nature of your Microsoft 365 organization as described in the following table:
33-
34-
****
30+
If your organization is on-premises Exchange, and you have Exchange Enterprise CAL with Services licenses for EOP, your EOP PowerShell connection instructions are the same as Exchange Online PowerShell. Use the Exchange Online PowerShell connection instructions in [Connect to Exchange Online PowerShell](connect-to-exchange-online-powershell.md) instead of the instructions in this topic.
3531

36-
|Microsoft 365 offering|Cmdlet|_ConnectionUri_ value|_AzureADAuthorizationEndPointUri_ value|
37-
|---|---|---|---|
38-
|Microsoft 365|**Connect-IPPSSession**|https://ps.protection.outlook.com/powershell-liveid/|Not used|
39-
|Office 365 Germany|**Connect-IPPSSession**|`https://outlook.office.de/PowerShell-LiveID`|`https://login.microsoftonline.de/common`|
40-
|Exchange Enterprise CAL with Services licenses (on-premises Exchange)|**Connect-ExchangeOnline**|Not used|Not used|
41-
|
32+
- The requirements for installing and using the EXO V2 module are described in [Install and maintain the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module).
4233

4334
> [!TIP]
4435
> Having problems? Ask for help in the [Exchange Online Protection](https://go.microsoft.com/fwlink/p/?linkId=285351) forum.
@@ -56,11 +47,11 @@ If you account uses multi-factor authentication, use the steps in this section.
5647
2. The command that you need to run uses the following syntax:
5748

5849
```powershell
59-
<Connect-IPPSSession | Connect-ExchangeOnline> -UserPrincipalName <UPN> [-ConnectionUri <URL>] [-AzureADAuthorizationEndPointUri <URL>]
50+
Connect-IPPSSession -UserPrincipalName <UPN> [-ConnectionUri <URL>] [-AzureADAuthorizationEndPointUri <URL>]
6051
```
6152

6253
- _\<UPN\>_ is your account in user principal name format (for example, `[email protected]`).
63-
- The required cmdlet and _ConnectionUri_ and _AzureADAuthorizationEndPointUri_ parameter values are described in the table in the [What do you need to know before you begin?](#what-do-you-need-to-know-before-you-begin) section.
54+
- The required _ConnectionUri_ and _AzureADAuthorizationEndPointUrl_ values depend on the nature of your Microsoft 365 organization. For more information, see the parameter descriptions in [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession).
6455

6556
**This example connects to Exchange Online Protection PowerShell in a Microsoft 365 organization**:
6657

@@ -74,19 +65,13 @@ If you account uses multi-factor authentication, use the steps in this section.
7465
Connect-IPPSSession -UserPrincipalName [email protected] -ConnectionUri https://ps.protection.outlook.de/powershell-liveid/ -AzureADAuthorizationEndPointUri https://login.microsoftonline.de/common
7566
```
7667

77-
**This example connects to Exchange Online Protection PowerShell in an Exchange Enterprise CAL with Services organization**:
78-
79-
```powershell
80-
Connect-ExchangeOnline -UserPrincipalName [email protected]
81-
```
82-
83-
For detailed syntax and parameter information, see [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline) and [Connect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
68+
For detailed syntax and parameter information, see [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
8469

8570
> [!NOTE]
8671
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the Windows PowerShell window without disconnecting the session, you could use up all the remote PowerShell sessions available to you, and you'll need to wait for the sessions to expire. To disconnect the remote PowerShell session, run the following command.
8772
8873
```powershell
89-
Disconnect-ExchangeOnline
74+
Get-PSSession | Remove-PSSession
9075
```
9176

9277
## Connect to Exchange Online Protection PowerShell without using MFA
@@ -110,10 +95,10 @@ If your account doesn't use multi-factor authentication, use the steps in this s
11095
3. The command that you need to run uses the following syntax:
11196

11297
```powershell
113-
<Connect-IPPSSession | Connect-ExchangeOnline> -Credential $UserCredential -ConnectionUri <URL>
98+
Connect-IPPSSession -Credential $UserCredential -ConnectionUri <URL>
11499
```
115100

116-
The required cmdlet and _ConnectionUri_ parameter values are described in the table in the [What do you need to know before you begin?](#what-do-you-need-to-know-before-you-begin) section.
101+
The required _ConnectionUri_ value depends on the nature of your Microsoft 365 organization. For more information, see the parameter description in [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession).
117102

118103
**This example connects to Exchange Online Protection PowerShell in a Microsoft 365 organization**:
119104

@@ -127,19 +112,13 @@ If your account doesn't use multi-factor authentication, use the steps in this s
127112
Connect-IPPSSession -Credential $UserCredential -ConnectionUri https://ps.protection.outlook.de/powershell-liveid/
128113
```
129114

130-
**This example connects to Exchange Online Protection PowerShell in an Exchange Enterprise CAL with Services organization**:
131-
132-
```powershell
133-
Connect-ExchangeOnline -Credential $UserCredential
134-
```
135-
136-
For detailed syntax and parameter information, see [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline) and [Connect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
115+
For detailed syntax and parameter information, see [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).
137116

138117
> [!NOTE]
139118
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the Windows PowerShell window without disconnecting the session, you could use up all the remote PowerShell sessions available to you, and you'll need to wait for the sessions to expire. To disconnect the remote PowerShell session, run the following command.
140119
141120
```powershell
142-
Disconnect-ExchangeOnline
121+
Get-PSSession | Remove-PSSession
143122
```
144123

145124
## How do you know this worked?

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

Lines changed: 4 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -29,18 +29,6 @@ To use the older Exchange Online Remote PowerShell Module to connect to Security
2929

3030
- The requirements for installing and using the EXO V2 module are described in [Install and maintain the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module).
3131

32-
- The required _ConnectionUri_ and _AzureADAuthorizationEndPointUri_ parameter values depend on the nature of your Microsoft 365 organization as described in the following table:
33-
34-
****
35-
36-
|Microsoft 365 offering|_ConnectionUri_ value|_AzureADAuthorizationEndPointUri_ value|
37-
|---|---|---|
38-
|Microsoft 365 or Microsoft 365 GCC|Not used|Not used|
39-
|Microsoft 365 GCC High|`https://ps.compliance.protection.office365.us/powershell-liveid/`|`https://login.microsoftonline.us/common`|
40-
|Microsoft 365 DoD|`https://l5.ps.compliance.protection.office365.us/powershell-liveid/`|`https://login.microsoftonline.us/common`|
41-
|Office 365 Germany|`https://ps.compliance.protection.outlook.de/PowerShell-LiveID`|`https://login.microsoftonline.de/common`|
42-
|
43-
4432
## Connect to Security & Compliance PowerShell using MFA
4533

4634
If you account uses multi-factor authentication, use the steps in this section. Otherwise, skip to the [Connect to Security & Compliance Center PowerShell without using MFA](#connect-to-security--compliance-center-powershell-without-using-mfa) section.
@@ -57,13 +45,13 @@ If you account uses multi-factor authentication, use the steps in this section.
5745
Connect-IPPSSession -UserPrincipalName <UPN> [-ConnectionUri <URL>] [-AzureADAuthorizationEndPointUri <URL>]
5846
```
5947

60-
- \<UPN\> is your account in user principal name format (for example, `[email protected]`).
61-
- The required _ConnectionUri_ and _AzureADAuthorizationEndPointUri_ parameter values are described in the table in the [What do you need to know before you begin?](#what-do-you-need-to-know-before-you-begin) section.
48+
- _\<UPN\>_ is your account in user principal name format (for example, `[email protected]`).
49+
- The required _ConnectionUri_ and _AzureADAuthorizationEndPointUrl_ values depend on the nature of your Microsoft 365 organization. For more information, see the parameter descriptions in [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession).
6250

6351
**This example connects to Security & Compliance Center PowerShell in a Microsoft 365 or Microsoft 365 GCC organization**.
6452

6553
```powershell
66-
Connect-IPPSSession -UserPrincipalName chris@contoso.com -ConnectionUri https://ps.compliance.protection.outlook.com/powershell-liveid/
54+
Connect-IPPSSession -UserPrincipalName navin@contoso.com
6755
```
6856

6957
**This example connects to Security & Compliance Center PowerShell in an Office 365 Germany organization**.
@@ -117,7 +105,7 @@ If your account doesn't use multi-factor authentication, use the steps in this s
117105
Connect-IPPSSession -Credential $UserCredential -ConnectionUri <URL>
118106
```
119107

120-
The _ConnectionUri_ values are described in the table in the [What do you need to know before you begin?](#what-do-you-need-to-know-before-you-begin) section.
108+
The required _ConnectionUri_ value depends on the nature of your Microsoft 365 organization. For more information, see the parameter description in [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession).
121109

122110
**This example connects to Security & Compliance Center PowerShell in a Microsoft 365 or Microsoft 365 GCC organization**.
123111

exchange/exchange-ps/exchange/Connect-ExchangeOnline.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ monikerRange: "exchonline-ps"
1616
## SYNOPSIS
1717
This cmdlet is available only in the Exchange Online PowerShell V2 module. For more information, see [Conect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
1818

19-
Use the Connect-ExchangeOnline cmdlet in the Exchange Online PowerShell V2 module to connect to an Exchange Online organization.
19+
Use the Connect-ExchangeOnline cmdlet in the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. To connect to other PowerShell environments (for example, Security & Compliance Center PowerShell or standalone Exchange Online Protection PowerShell), use the [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession) cmdlet.
2020

2121
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
2222

@@ -73,13 +73,13 @@ After the Connect-ExchangeOnline command is successful, you can run ExO V2 modul
7373
## PARAMETERS
7474

7575
### -AzureADAuthorizationEndpointUri
76-
The AzureADAuthorizationEndpointUri parameter specifies the Azure AD Authorization endpoint Uri that can issue OAuth2 access tokens.
76+
The AzureADAuthorizationEndpointUri parameter specifies the Azure AD Authorization endpoint Uri that can issue OAuth2 access tokens. You use this parameter with multi-factor authentication (MFA) and federated authentication.
7777

78+
- For Exchange Online PowerShell in Microsoft 365 or Microsoft 365 GCC, don't use this parameter.
7879
- For Exchange Online PowerShell in Office 365 Germany, use the value <https://login.microsoftonline.de/common> for this parameter.
79-
8080
- For Exchange Online PowerShell in Microsoft 365 GCC High and Microsoft 365 DoD, use the value <https://login.microsoftonline.us/common> for this parameter.
8181

82-
To connect to other Exchange PowerShell environments (for example, Security & Compliance Center PowerShell or standalone Exchange Online Protection PowerShell), use this parameter with the [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession) cmdlet.
82+
**Note**: MFA authentication or federated authentication isn't available in Office 365 operated by 21Vianet.
8383

8484
```yaml
8585
Type: String
@@ -111,15 +111,15 @@ Accept wildcard characters: False
111111
```
112112
113113
### -ConnectionUri
114-
The ConnectionUri parameter specifies the connection endpoint for the remote PowerShell session.
114+
The ConnectionUri parameter specifies the connection endpoint for the remote Exchange Online PowerShell session.
115115
116+
- For Exchange Online PowerShell in Microsoft 365 or Microsoft 365 GCC, you don't use this parameter.
116117
- For Exchange Online PowerShell in Office 365 Germany, use the value <https://outlook.office.de/PowerShell-LiveID> for this parameter.
117-
118+
- For Exchange Online PowerShell in Office 365 operated by 21Vianet, use the value <https://partner.outlook.cn/PowerShell> for this parameter.
118119
- For Exchange Online PowerShell in Microsoft 365 GCC High, use the value <https://outlook.office365.us/powershell-liveid> for this parameter.
119-
120120
- For Exchange Online PowerShell in Microsoft 365 DoD, use the value <https://webmail.apps.mil/powershell-liveid> for this parameter.
121121
122-
To connect to other Exchange PowerShell environments (for example, Security & Compliance Center PowerShell or standalone Exchange Online Protection PowerShell), use this parameter with the [Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession) cmdlet.
122+
**Note**: If your organization is on-premises Exchange, and you have Exchange Enterprise CAL with Services licenses for EOP, use the this cmdlet without the _ConnectionUri_ parameter to connect to EOP PowerShell (the same connection instructions as Exchange Online PowerShell).
123123
124124
```yaml
125125
Type: String

0 commit comments

Comments
 (0)