Skip to content

Commit d22fd9b

Browse files
authored
Merge branch 'master' into patch-15
2 parents d978b60 + a76bf73 commit d22fd9b

9 files changed

+50
-86
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

exchange/docs-conceptual/exchange-online-powershell-v2.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -128,18 +128,20 @@ All versions of the EXO V2 module are supported in Windows PowerShell 5.1. Power
128128
The EXO V2 module is supported in the following versions of Windows:
129129

130130
- Windows 10
131-
- Windows 8.1<sup>3</sup>
131+
- Windows 8.1<sup>4</sup>
132132
- Windows Server 2019
133133
- Windows Server 2016
134-
- Windows Server 2012 or Windows Server 2012 R2<sup>3</sup>
134+
- Windows Server 2012 or Windows Server 2012 R2<sup>4</sup>
135135
- Windows 7 Service Pack 1 (SP1)<sup>1,</sup><sup>2,</sup><sup>3</sup>
136136
- Windows Server 2008 R2 SP1<sup>1,</sup><sup>2,</sup><sup>3</sup>
137137

138138
<sup>1</sup> This version of Windows has reached its end of support, and is now supported only in Azure virtual machines.
139139

140-
<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).
140+
<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.
141141

142-
<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).
142+
<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).
143+
144+
<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).
143145

144146
### Prerequisites for the EXO V2 module
145147

33.8 KB
Loading
27.2 KB
Loading

exchange/exchange-ps/exchange/Get-MyAnalyticsFeatureConfig.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,13 @@ Get-MyAnalyticsFeatureConfig -Identity <String>
2727
```
2828

2929
## DESCRIPTION
30-
To run this cmdlet, you need to be a member of the 'Global Administrator' or the 'Exchange Administrator' directory role group in the destination organization. To learn more about administrator role permissions in Azure Active Directory, see [Role template IDs](https://docs.microsoft.com/azure/active-directory/roles/permissions-reference#role-template-ids).
30+
This cmdlet requires the .NET Framework 4.7.2 or later. To run this cmdlet, you need to be a member of one of the following directory role groups in the destination organization:
31+
32+
- Global Administrator
33+
- Exchange Administrator
34+
- Insights Administrator
35+
36+
To learn more about administrator role permissions in Azure Active Directory, see [Role template IDs](https://docs.microsoft.com/azure/active-directory/roles/permissions-reference#role-template-ids).
3137

3238
## EXAMPLES
3339

exchange/exchange-ps/exchange/Get-UserBriefingConfig.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,13 @@ Get-UserBriefingConfig -Identity <string>
2626
```
2727

2828
## DESCRIPTION
29-
This cmdlet requires the .NET Framework 4.7.2 or later. Also, you need to be a member of the Organization Management role group (Global admins).
29+
This cmdlet requires the .NET Framework 4.7.2 or later. To run this cmdlet, you need to be a member of one of the following directory role groups in the destination organization:
30+
31+
- Global Administrator
32+
- Exchange Administrator
33+
- Insights Administrator
34+
35+
To learn more about administrator role permissions in Azure Active Directory, see [Role template IDs](https://docs.microsoft.com/azure/active-directory/roles/permissions-reference#role-template-ids).
3036

3137
## EXAMPLES
3238

exchange/exchange-ps/exchange/Set-IRMConfiguration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ This parameter is available only in the cloud-based service.
101101
102102
The AutomaticServiceUpdateEnabled parameter specifies whether to allow the automatic addition of new features within Azure Information Protection for your cloud-based organization. Valid values are:
103103
104-
- $true: New Azure Information Protection features announced through Microsoft 365 message center will be enabled automatically in your cloud-based organization. This is the default value.
104+
- $true: New Azure Information Protection features announced through Microsoft 365 message center will be enabled automatically in your cloud-based organization.
105105
- $false: Prevents new Azure Information Protection features from automatically being introduced into your tenant organization.
106106
107107
```yaml

exchange/exchange-ps/exchange/Set-MyAnalyticsFeatureConfig.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,13 @@ Set-MyAnalyticsFeatureConfig -Identity <String>
3030
```
3131

3232
## DESCRIPTION
33-
To run this cmdlet, you need to be a member of the 'Global Administrator' or the 'Exchange Administrator' directory role group in the destination organization. To learn more about administrator role permissions in Azure Active Directory, see [Role template IDs](https://docs.microsoft.com/azure/active-directory/roles/permissions-reference#role-template-ids).
33+
This cmdlet requires the .NET Framework 4.7.2 or later. To run this cmdlet, you need to be a member of one of the following directory role groups in the destination organization:
34+
35+
- Global Administrator
36+
- Exchange Administrator
37+
- Insights Administrator
38+
39+
To learn more about administrator role permissions in Azure Active Directory, see [Role template IDs](https://docs.microsoft.com/azure/active-directory/roles/permissions-reference#role-template-ids).
3440

3541
## EXAMPLES
3642

skype/skype-ps/skype/Set-CsTeamsMeetingPolicy.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -892,15 +892,18 @@ Accept wildcard characters: False
892892
```
893893
894894
### -WhoCanRegister
895-
This parameter is reserved for internal Microsoft use.
895+
Possible values:
896+
897+
- Everyone
898+
- EveryoneInCompany
896899
897900
```yaml
898-
Type: Object
901+
Type: Boolean
899902
Parameter Sets: (All)
900903
Aliases:
901904
Required: False
902905
Position: Named
903-
Default value: None
906+
Default value: Everyone
904907
Accept pipeline input: False
905908
Accept wildcard characters: False
906909
```

0 commit comments

Comments
 (0)