Skip to content

Commit 449154f

Browse files
authored
Merge branch 'main' into patch-2
2 parents 6daef77 + c42eada commit 449154f

File tree

237 files changed

+5120
-1000
lines changed

Some content is hidden

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

237 files changed

+5120
-1000
lines changed

.openpublishing.publish.config.json

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -49,18 +49,6 @@
4949
"mapping/monikerMapping.json"
5050
]
5151
},
52-
{
53-
"docset_name": "purviewinformationprotection-ps",
54-
"build_source_folder": "informationprotection",
55-
"build_output_subfolder": "purviewinformationprotection-ps",
56-
"locale": "en-us",
57-
"monikers": [],
58-
"open_to_public_contributors": true,
59-
"type_mapping": {
60-
"Conceptual": "Content"
61-
},
62-
"build_entry_point": "docs"
63-
},
6452
{
6553
"docset_name": "skype-ps",
6654
"build_source_folder": "skype",

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

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: App-only authentication in Exchange Online PowerShell and Security & Compliance PowerShell
33
ms.author: chrisda
44
author: chrisda
5-
manager: dansimp
5+
manager: deniseb
66
ms.date: 12/12/2023
77
ms.audience: Admin
88
audience: Admin
@@ -33,7 +33,7 @@ Certificate based authentication (CBA) or app-only authentication as described i
3333
>
3434
> For instructions on how to install or update the module, see [Install and maintain the Exchange Online PowerShell module](exchange-online-powershell-v2.md#install-and-maintain-the-exchange-online-powershell-module). For instructions on how to use the module in Azure automation, see [Manage modules in Azure Automation](/azure/automation/shared-resources/modules).
3535
>
36-
> - REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
36+
> - REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
3737
>
3838
> If the procedures in this article don't work for you, verify that you don't have Beta versions of the PackageManagement or PowerShellGet modules installed by running the following command: `Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions`.
3939
>
@@ -412,20 +412,22 @@ The supported Microsoft Entra roles are described in the following table:
412412
|Role|Exchange Online<br>PowerShell|Security & Compliance<br>PowerShell|
413413
|---|:---:|:---:|
414414
|[Compliance Administrator](/entra/identity/role-based-access-control/permissions-reference#compliance-administrator)|||
415-
|[Exchange Administrator](/entra/identity/role-based-access-control/permissions-reference#exchange-administrator)<sup>\*</sup>|||
415+
|[Exchange Administrator](/entra/identity/role-based-access-control/permissions-reference#exchange-administrator)¹|||
416416
|[Exchange Recipient Administrator](/entra/identity/role-based-access-control/permissions-reference#exchange-recipient-administrator)|||
417-
|[Global Administrator](/entra/identity/role-based-access-control/permissions-reference#global-administrator)<sup>\*</sup>|||
417+
|[Global Administrator](/entra/identity/role-based-access-control/permissions-reference#global-administrator)¹ ²|||
418418
|[Global Reader](/entra/identity/role-based-access-control/permissions-reference#global-reader)|||
419419
|[Helpdesk Administrator](/entra/identity/role-based-access-control/permissions-reference#helpdesk-administrator)|||
420-
|[Security Administrator](/entra/identity/role-based-access-control/permissions-reference#security-administrator)<sup>\*</sup>|||
420+
|[Security Administrator](/entra/identity/role-based-access-control/permissions-reference#security-administrator)¹|||
421421
|[Security Reader](/entra/identity/role-based-access-control/permissions-reference#security-reader)|||
422422

423-
> <sup>\*</sup> The Global Administrator and Exchange Administrator roles provide the required permissions for any task in Exchange Online PowerShell. For example:
424-
>
425-
> - Recipient management.
426-
> - Security and protection features. For example, anti-spam, anti-malware, anti-phishing, and the associated reports.
427-
>
428-
> The Security Administrator role does not have the necessary permissions for those same tasks.
423+
¹ The Global Administrator and Exchange Administrator roles provide the required permissions for any task in Exchange Online PowerShell. For example:
424+
425+
- Recipient management.
426+
- Security and protection features. For example, anti-spam, anti-malware, anti-phishing, and the associated reports.
427+
428+
The Security Administrator role does not have the necessary permissions for those same tasks.
429+
430+
² Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
429431

430432
For general instructions about assigning roles in Microsoft Entra ID, see [Assign Microsoft Entra roles to users](/entra/identity/role-based-access-control/manage-roles-portal).
431433

@@ -481,7 +483,7 @@ For general instructions about assigning roles in Microsoft Entra ID, see [Assig
481483
>
482484
> This method is supported only when you connect to Exchange Online PowerShell or Security & Compliance PowerShell in [REST API mode](exchange-online-powershell-v2.md#rest-api-connections-in-the-exo-v3-module). Security & Compliance PowerShell supports REST API mode in v3.2.0 or later.
483485
484-
For information about creating custom role groups, see [Create role groups in Exchange Online](/exchange/permissions-exo/role-groups#create-role-groups) and [Create Email & collaboration role groups in the Microsoft Defender portal](/microsoft-365/security/office-365-security/mdo-portal-permissions#create-email--collaboration-role-groups-in-the-microsoft-defender-portal). The custom role group that you assign to the application can contain any combination of built-in and custom roles.
486+
For information about creating custom role groups, see [Create role groups in Exchange Online](/exchange/permissions-exo/role-groups#create-role-groups) and [Create Email & collaboration role groups in the Microsoft Defender portal](/defender-office-365/mdo-portal-permissions#create-email--collaboration-role-groups-in-the-microsoft-defender-portal). The custom role group that you assign to the application can contain any combination of built-in and custom roles.
485487

486488
To assign custom role groups to the application using service principals, do the following steps:
487489

exchange/docs-conceptual/cmdlet-property-sets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Property sets in Exchange Online PowerShell module cmdlets
33
ms.author: chrisda
44
author: chrisda
5-
manager: dansimp
5+
manager: deniseb
66
ms.date: 9/1/2023
77
ms.audience: Admin
88
audience: Admin

exchange/docs-conceptual/connect-exo-powershell-managed-identity.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use Azure managed identities to connect to Exchange Online PowerShell
33
ms.author: chrisda
44
author: chrisda
5-
manager: dansimp
5+
manager: deniseb
66
ms.date: 8/24/2023
77
ms.audience: Admin
88
audience: Admin
@@ -35,7 +35,7 @@ The rest of this article explains how to connect using managed identity, and the
3535
>
3636
> You can use Microsoft Graph to replace most of the functionality from those cmdlets. For more information, see [Working with groups in Microsoft Graph](/graph/api/resources/groups-overview).
3737
>
38-
> REST API connections in the V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
38+
> REST API connections in the V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
3939
4040
## Connect to Exchange Online PowerShell using system-assigned managed identity
4141

@@ -361,20 +361,22 @@ Now that the Office 365 Exchange Online resource is available, return to Step 4.
361361
The supported Microsoft Entra roles are described in the following list:
362362

363363
- [Compliance Administrator](/entra/identity/role-based-access-control/permissions-reference#compliance-administrator)
364-
- [Exchange Administrator](/entra/identity/role-based-access-control/permissions-reference#exchange-administrator)<sup>\*</sup>
364+
- [Exchange Administrator](/entra/identity/role-based-access-control/permissions-reference#exchange-administrator)¹
365365
- [Exchange Recipient Administrator](/entra/identity/role-based-access-control/permissions-reference#exchange-recipient-administrator)
366-
- [Global Administrator](/entra/identity/role-based-access-control/permissions-reference#global-administrator)<sup>\*</sup>
366+
- [Global Administrator](/entra/identity/role-based-access-control/permissions-reference#global-administrator)¹ ²
367367
- [Global Reader](/entra/identity/role-based-access-control/permissions-reference#global-reader)
368368
- [Helpdesk Administrator](/entra/identity/role-based-access-control/permissions-reference#helpdesk-administrator)
369-
- [Security Administrator](/entra/identity/role-based-access-control/permissions-reference#security-administrator)<sup>\*</sup>
369+
- [Security Administrator](/entra/identity/role-based-access-control/permissions-reference#security-administrator)¹
370370
- [Security Reader](/entra/identity/role-based-access-control/permissions-reference#security-reader)
371371

372-
> <sup>\*</sup> The Global Administrator and Exchange Administrator roles provide the required permissions for any task in Exchange Online PowerShell. For example:
373-
>
374-
> - Recipient management.
375-
> - Security and protection features. For example, anti-spam, anti-malware, anti-phishing, and the associated reports.
376-
>
377-
> The Security Administrator role does not have the necessary permissions for those same tasks.
372+
¹ The Global Administrator and Exchange Administrator roles provide the required permissions for any task in Exchange Online PowerShell. For example:
373+
374+
- Recipient management.
375+
- Security and protection features. For example, anti-spam, anti-malware, anti-phishing, and the associated reports.
376+
377+
The Security Administrator role does not have the necessary permissions for those same tasks.
378+
379+
² Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
378380

379381
For general instructions about assigning roles in Microsoft Entra ID, see [Assign Microsoft Entra roles to users](/entra/identity/role-based-access-control/manage-roles-portal).
380382

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Connect to Exchange Online PowerShell
33
author: chrisda
4-
manager: dansimp
4+
manager: deniseb
55
ms.date: 8/21/2023
66
ms.audience: Admin
77
audience: Admin
@@ -33,7 +33,7 @@ To connect to Exchange Online PowerShell from C#, see [Use C# to connect to Exch
3333
> [!NOTE]
3434
> Remote PowerShell connections are deprecated in Exchange Online PowerShell. For more information, see [Deprecation of Remote PowerShell in Exchange Online](https://techcommunity.microsoft.com/t5/exchange-team-blog/deprecation-of-remote-powershell-in-exchange-online-re-enabling/ba-p/3779692).
3535
>
36-
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
36+
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
3737
3838
- 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).
3939

@@ -237,7 +237,7 @@ If you receive errors, check the following requirements:
237237

238238
> The term 'Update-ModuleManifest' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
239239
240-
For more information about the PowerShellGet and PackageManagement module requirements, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
240+
For more information about the PowerShellGet and PackageManagement module requirements, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
241241

242242
- After you connect, you might received an error that looks like this:
243243

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Connect to Exchange Online Protection PowerShell
33
author: chrisda
4-
manager: dansimp
4+
manager: deniseb
55
ms.date: 8/21/2023
66
ms.audience: Admin
77
audience: Admin
@@ -29,7 +29,7 @@ For more information about Exchange Online Protection PowerShell, see [Exchange
2929
>
3030
> Remote PowerShell connections in Exchange Online PowerShell are deprecated. For more information, see [Deprecation of Remote PowerShell in Exchange Online](https://techcommunity.microsoft.com/t5/exchange-team-blog/deprecation-of-remote-powershell-in-exchange-online-re-enabling/ba-p/3779692).
3131
>
32-
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
32+
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
3333
3434
## What do you need to know before you begin?
3535

exchange/docs-conceptual/connect-to-exchange-servers-using-remote-powershell.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Connect to Exchange servers using remote PowerShell"
33
ms.author: chrisda
44
author: chrisda
5-
manager: dansimp
5+
manager: deniseb
66
ms.date: 9/7/2023
77
ms.audience: ITPro
88
audience: ITPro

exchange/docs-conceptual/connect-to-exo-powershell-c-sharp.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use C# to connect to Exchange Online PowerShell
33
ms.author: chrisda
44
author: chrisda
5-
manager: dansimp
5+
manager: deniseb
66
ms.date: 8/21/2023
77
ms.audience: Admin
88
audience: Admin
@@ -24,7 +24,7 @@ The code samples in this article use the [Exchange Online PowerShell V3 module](
2424
To install the Exchange Online PowerShell module, see [Install and maintain the Exchange Online PowerShell module](exchange-online-powershell-v2.md#install-and-maintain-the-exchange-online-powershell-module).
2525

2626
> [!TIP]
27-
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
27+
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
2828
>
2929
> If you get errors when you try to connect, use the _SkipLoadingFormatData_ switch on the **Connect-ExchangeOnline** cmdlet.
3030

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Connect to Security & Compliance PowerShell
33
author: chrisda
4-
manager: dansimp
4+
manager: deniseb
55
ms.date: 12/12/2023
66
ms.audience: Admin
77
audience: Admin
@@ -31,9 +31,9 @@ To connect to Security & Compliance PowerShell for automation, see [App-only aut
3131
> [!NOTE]
3232
> Remote PowerShell connections are deprecated in Security & Compliance PowerShell. For more information, see [Deprecation of Remote PowerShell (RPS) Protocol in Security & Compliance PowerShell](https://techcommunity.microsoft.com/t5/exchange-team-blog/deprecation-of-remote-powershell-rps-protocol-in-security-and/ba-p/3815432).
3333
>
34-
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
34+
> REST API connections in the Exchange Online PowerShell V3 module require the PowerShellGet and PackageManagement modules. For more information, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
3535
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 the Microsoft Defender portal](/microsoft-365/security/office-365-security/mdo-portal-permissions) and [Permissions in the Microsoft Purview compliance portal](/microsoft-365/compliance/microsoft-365-compliance-center-permissions).
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 the Microsoft Defender portal](/defender-office-365/mdo-portal-permissions) and [Permissions in the Microsoft Purview compliance portal](/purview/purview-compliance-portal-permissions).
3737

3838
## Step 1: Load the Exchange Online PowerShell module
3939

@@ -180,7 +180,7 @@ If you receive errors, check the following requirements:
180180

181181
> The term 'Update-ModuleManifest' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
182182
183-
For more information about the PowerShellGet and PackageManagement module requirements, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-based-connections-in-windows).
183+
For more information about the PowerShellGet and PackageManagement module requirements, see [PowerShellGet for REST-based connections in Windows](exchange-online-powershell-v2.md#powershellget-for-rest-api-connections-in-windows).
184184

185185
- You might fail to connect if your client IP address changes during the connection request. This can happen if your organization uses a source network address translation (SNAT) pool that contains multiple IP addresses. The connection error looks like this:
186186

exchange/docs-conceptual/control-remote-powershell-access-to-exchange-servers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Control remote PowerShell access to Exchange servers"
33
ms.author: chrisda
44
author: chrisda
5-
manager: dansimp
5+
manager: deniseb
66
ms.date: 9/7/2023
77
ms.audience: ITPro
88
audience: ITPro

0 commit comments

Comments
 (0)