Skip to content

Commit ae00412

Browse files
committed
Merge branch 'master' into SkipRules-chrisda
2 parents ec03a4f + 27e394d commit ae00412

File tree

2,169 files changed

+51289
-28725
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

2,169 files changed

+51289
-28725
lines changed

exchange/docfx.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,10 @@
8181
"ms.date": "09/25/2017",
8282
"ms.topic": "reference",
8383
"ms.service": "exchange-powershell",
84+
"products": [
85+
"https://authoring-docs-microsoft.poolparty.biz/devrel/0b654e73-5728-4af3-8c2e-17bfbf4c9f23",
86+
"https://authoring-docs-microsoft.poolparty.biz/devrel/8bce367e-2e90-4b56-9ed5-5e4e9f3a2dc3"
87+
],
8488
"ms.devlang": "powershell",
8589
"feedback_system": "GitHub",
8690
"feedback_github_repo": "MicrosoftDocs/office-docs-powershell",

exchange/docs-conceptual/app-only-auth-powershell-v2.md

Lines changed: 127 additions & 59 deletions
Large diffs are not rendered by default.

exchange/docs-conceptual/basic-auth-connect-to-eop-powershell.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ author: chrisda
55
manager: dansimp
66
ms.date:
77
ms.audience: Admin
8+
audience: Admin
89
ms.topic: article
910
ms.service: exchange-powershell
1011
localization_priority: Normal
@@ -16,7 +17,7 @@ description: "Use remote PowerShell to connect to a standalone Exchange Online P
1617
# Bssic auth - Connect to Exchange Online Protection PowerShell
1718

1819
> [!NOTE]
19-
> The connection instructions in this topic [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163) due to the security concerns around Basic authentication. Instead, you should use the Exchange Online PowerShell V2 module (the EXO V2 module) to connect to Exchange Online Protection PowerShell. For instructions, see [Connect to Exchange Online Protection PowerShell](connect-to-exchange-online-protection-powershell.md).
20+
> The connection instructions in this article [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163) due to the security concerns around Basic authentication. Instead, you should use the Exchange Online PowerShell V2 module (the EXO V2 module) to connect to Exchange Online Protection PowerShell. For instructions, see [Connect to Exchange Online Protection PowerShell](connect-to-exchange-online-protection-powershell.md).
2021
2122
In standalone Exchange Online Protection (EOP) organizations without Exchange Online mailboxes, standalone EOP PowerShell allows you to manage your EOP organization from the command line. You use Windows PowerShell on your local computer to create a remote PowerShell session to EOP. It's a simple three-step process where you enter your Microsoft 365 credentials, provide the required connection settings, and then import the EOP cmdlets into your local Windows PowerShell session so that you can use them.
2223

@@ -30,7 +31,9 @@ The following introductory video shows you how to connect to and use Exchange On
3031

3132
- Estimated time to complete: 5 minutes
3233

33-
- **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).
34+
- **The procedures in this article 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).
35+
36+
- After you connect, the cmdlets and parameters that you have or don't have access to is controlled by role-based access control (RBAC). For more information, see [Permissions in standalone EOP](/microsoft-365/security/office-365-security/feature-permissions-in-eop).
3437

3538
- You can use the following versions of Windows:
3639

@@ -42,7 +45,7 @@ The following introductory video shows you how to connect to and use Exchange On
4245
- Windows 7 Service Pack 1 (SP1)<sup>\*</sup>
4346
- Windows Server 2008 R2 SP1<sup>\*</sup>
4447

45-
<sup>\*</sup> This version of Windows has reached end of support, and is now only supported when running in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](https://docs.microsoft.com/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
48+
<sup>\*</sup> This version of Windows has reached end of support, and is now supported only in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
4649

4750
- Windows PowerShell needs to be configured to run scripts, and by default, it isn't. You'll get the following error when you try to connect:
4851

@@ -54,7 +57,7 @@ The following introductory video shows you how to connect to and use Exchange On
5457
Set-ExecutionPolicy RemoteSigned
5558
```
5659

57-
For more information about execution policies, see [About Execution Policies](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_execution_policies).
60+
For more information about execution policies, see [About Execution Policies](/powershell/module/microsoft.powershell.core/about/about_execution_policies).
5861

5962
- WinRM needs to allow Basic authentication (it's enabled by default). We don't send the username and password combination, but the Basic authentication header is required to send the session's OAuth token, since the client-side WinRM implementation has no support for OAuth.
6063

@@ -128,7 +131,7 @@ If you receive errors, check the following requirements:
128131

129132
- TCP port 80 traffic needs to be open between your local computer and Microsoft 365. It's probably open, but it's something to consider if your organization has a restrictive Internet access policy.
130133

131-
- The account you use to connect to Exchange Online Protection PowerShell must be represented as a [mail user in EOP](https://docs.microsoft.com/microsoft-365/security/office-365-security/manage-mail-users-in-eop) (created manually or by directory synchronization). If the account is not visible in the Exchange admin center (EAC) as a mail user at **Recipients** \> **Contacts**, you'll receive the following error when you try to connect:
134+
- The account you use to connect to Exchange Online Protection PowerShell must be represented as a [mail user in EOP](/microsoft-365/security/office-365-security/manage-mail-users-in-eop) (created manually or by directory synchronization). If the account is not visible in the Exchange admin center (EAC) as a mail user at **Recipients** \> **Contacts**, you'll receive the following error when you try to connect:
132135

133136
> Import-PSSession : Running the Get-Command command in a remote session reported the following error: Processing data for a remote command failed with the following error message: The request for the Windows Remote Shell with ShellId <GUID> 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.
134137
@@ -140,10 +143,10 @@ If you receive errors, check the following requirements:
140143

141144
## See also
142145

143-
The cmdlets that you use in this topic are Windows PowerShell cmdlets. For more information about these cmdlets, see the following topics.
146+
The cmdlets that you use in this article are Windows PowerShell cmdlets. For more information about these cmdlets, see the following articles.
144147

145-
- [Get-Credential](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/get-credential)
146-
- [New-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssession)
147-
- [Import-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/import-pssession)
148-
- [Remove-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/remove-pssession)
149-
- [Set-ExecutionPolicy](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/set-executionpolicy)
148+
- [Get-Credential](/powershell/module/microsoft.powershell.security/get-credential)
149+
- [New-PSSession](/powershell/module/microsoft.powershell.core/new-pssession)
150+
- [Import-PSSession](/powershell/module/microsoft.powershell.utility/import-pssession)
151+
- [Remove-PSSession](/powershell/module/microsoft.powershell.core/remove-pssession)
152+
- [Set-ExecutionPolicy](/powershell/module/microsoft.powershell.security/set-executionpolicy)

exchange/docs-conceptual/basic-auth-connect-to-exo-powershell.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ author: chrisda
55
manager: dansimp
66
ms.date:
77
ms.audience: Admin
8+
audience: Admin
89
ms.topic: article
910
ms.service: exchange-powershell
1011
localization_priority: Priority
@@ -19,7 +20,7 @@ description: "Learn how to use remote PowerShell to connect to Exchange Online w
1920
# Basic auth - Connect to Exchange Online PowerShell
2021

2122
> [!NOTE]
22-
> The connection instructions in this topic [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163) due to the security concerns around Basic authentication. Instead, you should use the Exchange Online PowerShell V2 module (the EXO V2 module) to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](connect-to-exchange-online-powershell.md).
23+
> The connection instructions in this article [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163) due to the security concerns around Basic authentication. Instead, you should use the Exchange Online PowerShell V2 module (the EXO V2 module) to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](connect-to-exchange-online-powershell.md).
2324
2425
Exchange Online PowerShell allows you to manage your Exchange Online settings from the command line. You use Windows PowerShell on your local computer to create a remote PowerShell session to Exchange Online. It's a simple three-step process where you enter your Microsoft 365 credentials, provide the required connection settings, and then import the Exchange Online cmdlets into your local Windows PowerShell session so that you can use them.
2526

@@ -33,7 +34,9 @@ The following introductory video shows you how to connect to and use Exchange On
3334

3435
- Estimated time to complete: 5 minutes
3536

36-
- If your on-premises Exchange organization has Exchange Enterprise CAL with Services licenses, you can use the instructions in this topic to connect to your EOP organization.
37+
- After you connect, the cmdlets and parameters that you have or don't have access to is controlled by role-based access control (RBAC). For more information, see [Permissions in Exchange Online](/exchange/permissions-exo/permissions-exo).
38+
39+
- If your on-premises Exchange organization has Exchange Enterprise CAL with Services licenses, you can use the instructions in this article to connect to your EOP organization.
3740

3841
- You can use the following versions of Windows:
3942

@@ -45,7 +48,7 @@ The following introductory video shows you how to connect to and use Exchange On
4548
- Windows 7 Service Pack 1 (SP1)<sup>*</sup>
4649
- Windows Server 2008 R2 SP1<sup>*</sup>
4750

48-
<sup>\*</sup> This version of Windows has reached end of support, and is now only supported when running in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](https://docs.microsoft.com/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
51+
<sup>\*</sup> This version of Windows has reached end of support, and is now supported only in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
4952

5053
- Windows PowerShell needs to be configured to run scripts, and by default, it isn't. You'll get the following error when you try to connect:
5154

@@ -57,7 +60,7 @@ The following introductory video shows you how to connect to and use Exchange On
5760
Set-ExecutionPolicy RemoteSigned
5861
```
5962

60-
For more information about execution policies, see [About Execution Policies](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_execution_policies).
63+
For more information about execution policies, see [About Execution Policies](/powershell/module/microsoft.powershell.core/about/about_execution_policies).
6164

6265
- WinRM needs to allow Basic authentication (it's enabled by default). We don't send the username and password combination, but the Basic authentication header is required to send the session's OAuth token, since the client-side WinRM implementation has no support for OAuth.
6366

@@ -111,7 +114,7 @@ The following introductory video shows you how to connect to and use Exchange On
111114

112115
Then, add the following parameter and value to the end of the $Session = ... command: `-SessionOption $ProxyOptions`.
113116

114-
For more information, see [New-PSSessionOption](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssessionoption).
117+
For more information, see [New-PSSessionOption](/powershell/module/microsoft.powershell.core/new-pssessionoption).
115118

116119
3. Run the following command:
117120

@@ -144,12 +147,12 @@ If you receive errors, check the following requirements:
144147

145148
## See also
146149

147-
The cmdlets that you use in this topic are Windows PowerShell cmdlets. For more information about these cmdlets, see the following topics.
150+
The cmdlets that you use in this article are Windows PowerShell cmdlets. For more information about these cmdlets, see the following articles.
148151

149-
- [Get-Credential](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/get-credential)
150-
- [New-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssession)
151-
- [Import-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/import-pssession)
152-
- [Remove-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/remove-pssession)
153-
- [Set-ExecutionPolicy](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/set-executionpolicy)
152+
- [Get-Credential](/powershell/module/microsoft.powershell.security/get-credential)
153+
- [New-PSSession](/powershell/module/microsoft.powershell.core/new-pssession)
154+
- [Import-PSSession](/powershell/module/microsoft.powershell.utility/import-pssession)
155+
- [Remove-PSSession](/powershell/module/microsoft.powershell.core/remove-pssession)
156+
- [Set-ExecutionPolicy](/powershell/module/microsoft.powershell.security/set-executionpolicy)
154157

155-
For more information about managing Microsoft 365, see [Manage Microsoft 365 and Office 365](https://docs.microsoft.com/Office365/).
158+
For more information about managing Microsoft 365, see [Manage Microsoft 365 and Office 365](/Office365/).

0 commit comments

Comments
 (0)