Skip to content

Commit abac23c

Browse files
committed
Simplified ExO connection instructions
1 parent 0dd5d17 commit abac23c

File tree

3 files changed

+16
-75
lines changed

3 files changed

+16
-75
lines changed

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

Lines changed: 16 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -42,30 +42,35 @@ To use the older Exchange Online Remote PowerShell Module to connect to Exchange
4242
> [!TIP]
4343
> Having problems? Ask in the [Exchange Online](https://go.microsoft.com/fwlink/p/?linkId=267542) forum.
4444
45-
## Connect to Exchange Online PowerShell using MFA and modern authentication
45+
## Connect to Exchange Online PowerShell using modern authentication with or without MFA
4646

47-
If your account uses multi-factor authentication, use the steps in this section. Otherwise, skip to the [Connect to Exchange Online PowerShell using modern authentication](#connect-to-exchange-online-powershell-using-modern-authentication) section.
47+
These connection instructions use modern authentication and work with or without multi-factor authentication (MFA).
4848

49-
**Note**: For other sign in methods that are available in PowerShell 7, see the [PowerShell 7 log in experiences](#powershell-7-log-in-experiences) section later in this topic.
49+
For other sign in methods that are available in PowerShell 7, see the [PowerShell 7 log in experiences](#powershell-7-log-in-experiences) section later in this topic.
5050

5151
1. In a PowerShell window, load the EXO V2 module by running the following command:
5252

5353
```powershell
5454
Import-Module ExchangeOnlineManagement
5555
```
5656

57-
**Note**: If you've already [installed the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module), the previous command will work as written.
57+
**Notes**:
58+
59+
- If you've already [installed the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module), the previous command will work as written.
60+
- You might be able to skip this step and run **Connect-ExchangeOnline** without loading the module first.
5861

5962
2. The command that you need to run uses the following syntax:
6063

6164
```powershell
62-
Connect-ExchangeOnline -UserPrincipalName <UPN> [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
65+
Connect-ExchangeOnline -UserPrincipalName <UPN> [-ShowBanner:$false] [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
6366
```
6467

6568
- _\<UPN\>_ is your account in user principal name format (for example, `[email protected]`).
6669
- When you use the _ExchangeEnvironmentName_ parameter, you don't need use the _ConnectionUri_ or _AzureADAuthorizationEndPointUrl_ parameters. For more information, see the parameter descriptions in [Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline).
6770
- The _DelegatedOrganization_ parameter specifies the customer organization that you want to manage as an authorized Microsoft Partner. For more information, see [Partners](/office365/servicedescriptions/office-365-platform-service-description/partners).
6871
- If you're behind a proxy server, run this command first: `$ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>`, where \<Value\> is `IEConfig`, `WinHttpConfig`, or `AutoDetect`. Then, use the _PSSessionOption_ parameter with the value `$ProxyOptions`. For more information, see [New-PSSessionOption](/powershell/module/microsoft.powershell.core/new-pssessionoption).
72+
- You can often omit the _UserPrincipalName_ parameter in the next step to enter both the username and password after you run the **Connect-ExchangeOnline** command. If it doesn't work, then you need to use the _UserPrincipalName_ parameter.
73+
- If you aren't using MFA, you can often use the _Credential_ parameter instead of the _UserPrincipalName_ parameter. First, run the command `$Credential = Get-Credential`, enter your username and password, and then use the variable name for the _Credential_ parameter (`-Credential $Credential`). If it doesn't work, then you need to use the _UserPrincipalName_ parameter.
6974

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

@@ -97,84 +102,20 @@ If your account uses multi-factor authentication, use the steps in this section.
97102
Connect-ExchangeOnline -UserPrincipalName [email protected] -DelegatedOrganization adatum.onmicrosoft.com
98103
```
99104

100-
For detailed syntax and parameter information, see [Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline).
105+
3. In the sign-in window that opens, enter your password, and then click **Sign in**.
101106

102-
> [!NOTE]
103-
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the 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.
107+
![Enter your password in the Sign in to your account window](media/connect-exo-password-prompt.png)
104108

105-
```powershell
106-
Disconnect-ExchangeOnline
107-
```
109+
4. **MFA only**: A verification code is generated and delivered based on the response option that's configured for your account (for example, a text message or the Microsoft Authenticator app on your device).
108110

109-
## Connect to Exchange Online PowerShell using modern authentication
111+
In the verification window that opens, enter the verification code, and then click **Verify**.
110112

111-
If your account doesn't use multi-factor authentication, use the steps in this section.
112-
113-
**Note**: For other sign in methods that are available in PowerShell 7, see the [PowerShell 7 log in experiences](#powershell-7-log-in-experiences) section later in this topic.
114-
115-
1. In a PowerShell window, load the EXO V2 module by running the following command:
116-
117-
```powershell
118-
Import-Module ExchangeOnlineManagement
119-
```
120-
121-
**Note**: If you've already [installed the EXO V2 module](exchange-online-powershell-v2.md#install-and-maintain-the-exo-v2-module), the previous command will work as written.
122-
123-
2. Run the following command:
124-
125-
> [!NOTE]
126-
> You can skip this step and omit the _Credential_ parameter in the next step to be prompted to enter the username and password after you run the **Connect-ExchangeOnline** command. If you omit the _Credential_ parameter and include the _UserPrincipalName_ parameter in the next step, you're only prompted to enter the password after you run the **Connect-ExchangeOnline** command.
127-
128-
```powershell
129-
$UserCredential = Get-Credential
130-
```
131-
132-
In the credentials prompt, enter your work or school account and password.
133-
134-
3. The last command that you need to run uses the following syntax:
135-
136-
```powershell
137-
Connect-ExchangeOnline [-Credential $UserCredential] [-ShowBanner:$false] [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
138-
```
139-
140-
- When you use the _ExchangeEnvironmentName_ parameter, you don't need use the _ConnectionUri_ or _AzureADAuthorizationEndPointUrl_ parameters. For more information, see the parameter descriptions in [Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline).
141-
- The _DelegatedOrganization_ parameter specifies the customer organization that you want to manage as an authorized Microsoft Partner. For more information, see [Partners](/office365/servicedescriptions/office-365-platform-service-description/partners).
142-
- If you're behind a proxy server, store the output of the [New-PSSessionOption](/powershell/module/microsoft.powershell.core/new-pssessionoption) cmdlet in a variable (for example, `$ProxyOptions = New-PSSessionOption -ProxyAccessType <Value> [-ProxyAuthentication <Value>] [-ProxyCredential <Value>]`). Then, use the variable (`$ProxyOptions`) as the value for the _PSSessionOption_ parameter.
143-
144-
**Connect to Exchange Online PowerShell in a Microsoft 365 or Microsoft 365 GCC organization**:
145-
146-
```powershell
147-
Connect-ExchangeOnline -Credential $UserCredential
148-
```
149-
150-
**Connect to Exchange Online PowerShell in an Office 365 Germany organization**:
151-
152-
```powershell
153-
Connect-ExchangeOnline -Credential $UserCredential -ExchangeEnvironmentName O365GermanyCloud
154-
```
155-
156-
**Connect to Exchange Online PowerShell in an Office 365 operated by 21Vianet organization**:
157-
158-
```powershell
159-
Connect-ExchangeOnline -Credential $UserCredential -ExchangeEnvironmentName O365China
160-
```
161-
162-
**Connect to Exchange Online PowerShell in a Microsoft 365 GCC High organization**:
163-
164-
```powershell
165-
Connect-ExchangeOnline -Credential $UserCredential -ExchangeEnvironmentName O365USGovGCCHigh
166-
```
167-
168-
**Connect to Exchange Online PowerShell in a Microsoft 365 DoD organization**:
169-
170-
```powershell
171-
Connect-ExchangeOnline -Credential $UserCredential -ExchangeEnvironmentName O365USGovDoD
172-
```
113+
![Enter your verification code in the Sign in to your account window](media/connect-exo-mfa-verify-prompt.png)
173114

174115
For detailed syntax and parameter information, see [Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline).
175116

176117
> [!NOTE]
177-
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the 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:
118+
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the 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.
178119
179120
```powershell
180121
Disconnect-ExchangeOnline
33.8 KB
Loading
27.2 KB
Loading

0 commit comments

Comments
 (0)