You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: exchange/docs-conceptual/connect-to-exchange-online-powershell.md
+16-75Lines changed: 16 additions & 75 deletions
Original file line number
Diff line number
Diff line change
@@ -42,30 +42,35 @@ To use the older Exchange Online Remote PowerShell Module to connect to Exchange
42
42
> [!TIP]
43
43
> Having problems? Ask in the [Exchange Online](https://go.microsoft.com/fwlink/p/?linkId=267542) forum.
44
44
45
-
## Connect to Exchange Online PowerShell using MFA and modern authentication
45
+
## Connect to Exchange Online PowerShell using modern authentication with or without MFA
46
46
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).
48
48
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.
50
50
51
51
1. In a PowerShell window, load the EXO V2 module by running the following command:
52
52
53
53
```powershell
54
54
Import-Module ExchangeOnlineManagement
55
55
```
56
56
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.
58
61
59
62
2. The command that you need to run uses the following syntax:
-_\<UPN\>_ is your account in user principal name format (for example, `[email protected]`).
66
69
- 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).
67
70
- 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).
68
71
- 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.
69
74
70
75
**This example connects to Exchange Online PowerShell in a Microsoft 365 or Microsoft 365 GCC organization**:
71
76
@@ -97,84 +102,20 @@ If your account uses multi-factor authentication, use the steps in this section.
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**.
101
106
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
+
104
108
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).
108
110
109
-
## Connect to Exchange Online PowerShell using modern authentication
111
+
In the verification window that opens, enter the verification code, and then click **Verify**.
110
112
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:
- 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**:
173
114
174
115
For detailed syntax and parameter information, see [Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline).
175
116
176
117
> [!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.
Copy file name to clipboardExpand all lines: exchange/docs-conceptual/exchange-online-powershell-v2.md
+6-4Lines changed: 6 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -130,18 +130,20 @@ All versions of the EXO V2 module are supported in Windows PowerShell 5.1. Power
130
130
The EXO V2 module is supported in the following versions of Windows:
131
131
132
132
- Windows 10
133
-
- Windows 8.1<sup>3</sup>
133
+
- Windows 8.1<sup>4</sup>
134
134
- Windows Server 2019
135
135
- Windows Server 2016
136
-
- Windows Server 2012 or Windows Server 2012 R2<sup>3</sup>
136
+
- Windows Server 2012 or Windows Server 2012 R2<sup>4</sup>
137
137
- Windows 7 Service Pack 1 (SP1)<sup>1,</sup><sup>2,</sup><sup>3</sup>
138
138
- Windows Server 2008 R2 SP1<sup>1,</sup><sup>2,</sup><sup>3</sup>
139
139
140
140
<sup>1</sup> This version of Windows has reached its end of support, and is now supported only in Azure virtual machines.
141
141
142
-
<sup>2</sup> Windows PowerShell 5.1 on this version of Windows requires the Microsoft .NET Framework 4.5 or later and the Windows Management Framework 5.1. For more information, see [Windows Management Framework 5.1](https://aka.ms/wmf5download).
142
+
<sup>2</sup> This version of Windows doesn't support version 2.0.4 or later of the EXO V2 module. Only version 2.0.3 or earlier is supported.
143
143
144
-
<sup>3</sup> PowerShell 7 on this version of Windows requires the [Windows 10 Universal C Runtime (CRT)](https://www.microsoft.com/download/details.aspx?id=50410).
144
+
<sup>3</sup> Windows PowerShell 5.1 on this version of Windows requires the Microsoft .NET Framework 4.5 or later and the Windows Management Framework 5.1. For more information, see [Windows Management Framework 5.1](https://aka.ms/wmf5download).
145
+
146
+
<sup>4</sup> PowerShell 7 on this version of Windows requires the [Windows 10 Universal C Runtime (CRT)](https://www.microsoft.com/download/details.aspx?id=50410).
The Owner parameter specifies the owner of the Active Directory object. If the name of the owner contains spaces, enclose the name in quotation marks (").
136
+
The Owner parameter specifies the owner of the Active Directory object. You can specify the following types of users or groups (security principals) for this parameter:
137
137
138
-
The Owner parameter can only be used with the Identity parameter and no other parameters.
138
+
- Mailbox users
139
+
- Mail users
140
+
- Security groups
141
+
142
+
You can use any value that uniquely identifies the user or group. For example:
143
+
144
+
- Name
145
+
- Alias
146
+
- Distinguished name (DN)
147
+
- Canonical DN
148
+
- Domain\\Username
149
+
- Email address
150
+
- GUID
151
+
- LegacyExchangeDN
152
+
- SamAccountName
153
+
- User ID or user principal name (UPN)
154
+
155
+
You can't use this parameter with the AccessRights or User parameters.
The User parameter specifies the user that the permissions are being granted to on the object. If the name contains spaces, enclose the name in quotation marks (").
171
+
The User parameter specifies who gets the permissions on the Active Directory object. You can specify the following types of users or groups (security principals) for this parameter:
172
+
173
+
- Mailbox users
174
+
- Mail users
175
+
- Security groups
176
+
177
+
You can use any value that uniquely identifies the user or group. For example:
178
+
179
+
- Name
180
+
- Alias
181
+
- Distinguished name (DN)
182
+
- Canonical DN
183
+
- Domain\\Username
184
+
- Email address
185
+
- GUID
186
+
- LegacyExchangeDN
187
+
- SamAccountName
188
+
- User ID or user principal name (UPN)
189
+
190
+
You can't use this parameter with the Owner parameter.
The Owner parameter specifies the owner of the mailbox object. The default mailbox owner is NT AUTHORITY\\SELF.
200
+
The Owner parameter specifies the owner of the mailbox object. You can specify the following types of users or groups (security principals) for this parameter:
201
+
202
+
- Mailbox users
203
+
- Mail users
204
+
- Security groups
199
205
200
-
The owner that you specify for this parameter must be a user or security group (a security principal that can have permissions assigned). You can use any value that uniquely identifies the owner. For example: For example:
206
+
You can use any value that uniquely identifies the user or group. For example:
201
207
202
208
- Name
209
+
- Alias
203
210
- Distinguished name (DN)
204
211
- Canonical DN
212
+
- Domain\\Username
213
+
- Email address
205
214
- GUID
215
+
- LegacyExchangeDN
216
+
- SamAccountName
217
+
- User ID or user principal name (UPN)
218
+
219
+
The default mailbox owner is NT AUTHORITY\\SELF.
220
+
221
+
You can't use this parameter with the AccessRights or User parameters.
The User parameter specifies the user that you're assigning the permission to.
237
+
The User parameter specifies who gets the permissions on the mailbox. You can specify the following types of users or groups (security principals) for this parameter:
238
+
239
+
- Mailbox users
240
+
- Mail users
241
+
- Security groups
222
242
223
-
The user that you specify for this parameter must be a user or security group (a security principal that can have permissions assigned). You can use any value that uniquely identifies the user. For example: For example:
243
+
You can use any value that uniquely identifies the user or group. For example:
224
244
225
245
- Name
246
+
- Alias
226
247
- Distinguished name (DN)
227
248
- Canonical DN
249
+
- Domain\\Username
250
+
- Email address
228
251
- GUID
252
+
- LegacyExchangeDN
253
+
- SamAccountName
254
+
- User ID or user principal name (UPN)
255
+
256
+
You can't use this parameter with the Owner parameter.
The Owner parameter specifies the NT Owner access control list (ACL) on the object. Valid values are the user principal name (UPN), domain\\user, or alias.
172
+
The Owner parameter specifies the owner of the public folder object. You can specify the following types of users or groups (security principals) for this parameter:
173
+
174
+
- Mailbox users
175
+
- Mail users
176
+
- Security groups
177
+
178
+
You can use any value that uniquely identifies the user or group. For example:
179
+
180
+
- Name
181
+
- Alias
182
+
- Distinguished name (DN)
183
+
- Canonical DN
184
+
- Domain\\Username
185
+
- Email address
186
+
- GUID
187
+
- LegacyExchangeDN
188
+
- SamAccountName
189
+
- User ID or user principal name (UPN)
190
+
191
+
You can't use this parameter with the AccessRights or User parameters.
0 commit comments