Skip to content

Commit e393b1f

Browse files
authored
Merge branch 'main' into patch-4
2 parents c13e304 + 72a7644 commit e393b1f

File tree

151 files changed

+590
-684
lines changed

Some content is hidden

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

151 files changed

+590
-684
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
**Short URL: aka.ms/office-powershell**
2-
31
# Overview
42

3+
**Short URL**: <https://aka.ms/office-powershell>
4+
55
This repository holds reference content of Office PowerShell cmdlets for help purpose. The expert knowledge around Office PowerShell is distributed among customers, MVPs, partners, product teams, support, and other community members. Consumers have various preferences when consuming knowledge such as a website, PowerShell Get-Help, Windows app, iOS app, Android app, and others. The following diagram illustrates the point.
66

77
![Contribution and Consumption model for Office PowerShell reference content.](images/contrib-consumption-model.png)

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

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -265,10 +265,6 @@ After you register the certificate with your application, you can use the privat
265265

266266
Azure AD has more than 50 admin roles available. The supported roles are described in the following table:
267267

268-
<br>
269-
270-
****
271-
272268
|Role|Exchange Online PowerShell|Security & Compliance Center PowerShell|
273269
|---|:---:|:---:|
274270
|Compliance Administrator|![Check mark.](media/checkmark.png)|![Check mark.](media/checkmark.png)|
@@ -278,7 +274,6 @@ Azure AD has more than 50 admin roles available. The supported roles are describ
278274
|Helpdesk Administrator|![Check mark.](media/checkmark.png)||
279275
|Security Administrator<sup>\*</sup>|![Check mark.](media/checkmark.png)|![Check mark.](media/checkmark.png)|
280276
|Security Reader|![Check mark.](media/checkmark.png)|![Check mark.](media/checkmark.png)|
281-
|
282277

283278
<sup>\*</sup> The Global Administrator and Exchange Administrator roles provide the required permissions for any task in Exchange Online PowerShell. For example:
284279

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

Lines changed: 0 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,6 @@ For more information about filtering in the EXO V2 module, see [Filters in the E
2727

2828
The available property sets for the **Get-EXOCasMailbox** cmdlet and the properties they contain are described in the following table:
2929

30-
<br>
31-
32-
****
33-
3430
|PropertySet|Properties|
3531
|---|---|
3632
|**Minimum**|ActiveSyncEnabled <br> DisplayName <br> ECPEnabled <br> EmailAddresses <br> EwsEnabled <br> ExchangeVersion <br> Guid <br> Identity <br> ImapEnabled <br> MAPIEnabled <br> Name <br> OWAEnabled <br> OrganizationId <br> PopEnabled <br> PrimarySmtpAddress <br> ServerLegacyDN|
@@ -40,7 +36,6 @@ The available property sets for the **Get-EXOCasMailbox** cmdlet and the propert
4036
|**Mapi**|ExternalDirectoryObjectId <br> Guid <br> Identity <br> MAPIBlockOutlookExternalConnectivity <br> MAPIBlockOutlookNonCachedMode <br> MAPIBlockOutlookRpcHttp <br> MAPIBlockOutlookVersions <br> MAPIEnabled <br> MapiHttpEnabled <br> Name <br> OrganizationId|
4137
|**Pop**|ExternalDirectoryObjectId <br> Guid <br> Identity <br> Name <br> OrganizationId <br> PopEnableExactRFC822Size <br> PopEnabled <br> PopMessagesRetrievalMimeFormat <br> PopSuppressReadReceipt <br> PopUseProtocolDefaults|
4238
|**ProtocolSettings**|ExternalDirectoryObjectId <br> ExternalImapSettings <br> ExternalPopSettings <br> ExternalSmtpSettings <br> Guid <br> Identity <br> InternalImapSettings <br> InternalPopSettings <br> InternalSmtpSettings <br> Name <br> OrganizationId|
43-
|
4439

4540
**Note**: The following **Get-CasMailbox** parameters aren't available on **Get-EXOCasMailbox**:
4641

@@ -58,10 +53,6 @@ For more information, see:
5853

5954
The available property sets for the **Get-EXOMailbox** cmdlet and the properties they contain are described in the following table:
6055

61-
<br>
62-
63-
****
64-
6556
|PropertySet|Properties|
6657
|---|---|
6758
|**Minimum**|Alias <br> DisplayName <br> DistinguishedName <br> EmailAddresses <br> ExchangeVersion <br> ExternalDirectoryObjectId <br> Guid <br> Id <br> Name <br> OrganizationId <br> PrimarySmtpAddress <br> RecipientType <br> RecipientTypeDetails <br> UserPrincipalName|
@@ -81,7 +72,6 @@ The available property sets for the **Get-EXOMailbox** cmdlet and the properties
8172
|**SCL**|AntispamBypassEnabled <br> ExternalDirectoryObjectId <br> SCLDeleteEnabled <br> SCLDeleteThreshold <br> SCLJunkEnabled <br> SCLJunkThreshold <br> SCLQuarantineEnabled <br> SCLQuarantineThreshold <br> SCLRejectEnabled <br> SCLRejectThreshold|
8273
|**SoftDelete**|ExternalDirectoryObjectId <br> IncludeInGarbageCollection <br> IsInactiveMailbox <br> IsSoftDeletedByDisable <br> IsSoftDeletedByRemove <br> WhenSoftDeleted|
8374
|**StatisticsSeed**|ArchiveDatabaseGuid <br> DatabaseGuid <br> ExchangeGuid <br> ExternalDirectoryObjectId|
84-
|
8575

8676
**Note**: The following **Get-Mailbox** parameters aren't available on **Get-EXOMailbox**:
8777

@@ -100,15 +90,10 @@ For more information, see:
10090

10191
The available property sets for the **Get-EXOMailboxStatistics** cmdlet and the properties they contain are described in the following table:
10292

103-
<br>
104-
105-
****
106-
10793
|PropertySet|Properties|
10894
|---|---|
10995
|**Minimum**|DeletedItemCount <br> DisplayName <br> ItemCount <br> MailboxGuid <br> TotalDeletedItemSize <br> TotalItemSize|
11096
|**All**|AssociatedItemCount <br> AttachmentTableAvailableSize <br> AttachmentTableTotalSize <br> DatabaseIssueWarningQuota <br> DatabaseName <br> DatabaseProhibitSendQuota <br> DatabaseProhibitSendReceiveQuota <br> DeletedItemCount <br> DisconnectDate <br> DisconnectReason <br> DisplayName <br> DumpsterMessagesPerFolderCountReceiveQuota <br> DumpsterMessagesPerFolderCountWarningQuota <br> ExternalDirectoryOrganizationId <br> FastIsEnabled <br> FolderHierarchyChildrenCountReceiveQuota <br> FolderHierarchyChildrenCountWarningQuota <br> FolderHierarchyDepthReceiveQuota <br> FolderHierarchyDepthWarningQuota <br> FoldersCountReceiveQuota <br> FoldersCountWarningQuota <br> IsAbandonedMoveDestination <br> IsArchiveMailbox <br> IsDatabaseCopyActive <br> IsHighDensityShard <br> IsMoveDestination <br> IsQuarantined <br> ItemCount <br> LastLoggedOnUserAccount <br> LastLogoffTime <br> LastLogonTime <br> LegacyDN <br> MailboxGuid <br> MailboxMessagesPerFolderCountReceiveQuota <br> MailboxMessagesPerFolderCountWarningQuota <br> MailboxType <br> MailboxTypeDetail <br> MessageTableAvailableSize <br> MessageTableTotalSize <br> NamedPropertiesCountQuota <br> NeedsToMove <br> OtherTablesAvailableSize <br> OtherTablesTotalSize <br> OwnerADGuid <br> QuarantineClients <br> QuarantineDescription <br> QuarantineEnd <br> QuarantineFileVersion <br> QuarantineLastCrash <br> ResourceUsageRollingAvgDatabaseReads <br> ResourceUsageRollingAvgRop <br> ResourceUsageRollingClientTypes <br> ServerName <br> StorageLimitStatus <br> SystemMessageCount <br> SystemMessageSize <br> SystemMessageSizeShutoffQuota <br> SystemMessageSizeWarningQuota <br> TotalDeletedItemSize <br> TotalItemSize|
111-
|
11297

11398
For more information, see:
11499

@@ -119,18 +104,13 @@ For more information, see:
119104

120105
The available property sets for the **Get-EXORecipient** cmdlet and the properties they contain are described in the following table:
121106

122-
<br>
123-
124-
****
125-
126107
|PropertySet|Properties|
127108
|---|---|
128109
|**Minimum**|ExchangeVersion <br> ExternalDirectoryObjectID <br> Name <br> OrganizationId <br> RecipientType <br> RecipientTypeDetails|
129110
|**Archive**|ArchiveDatabase <br> ArchiveGuid <br> ArchiveRelease <br> ArchiveState <br> ArchiveStatus|
130111
|**Custom**|CustomAttribute1 <br> CustomAttribute2 <br> CustomAttribute3 <br> CustomAttribute4 <br> CustomAttribute5 <br> CustomAttribute6 <br> CustomAttribute7 <br> CustomAttribute8 <br> CustomAttribute9 <br> CustomAttribute10 <br> CustomAttribute11 <br> CustomAttribute12 <br> CustomAttribute13 <br> CustomAttribute14 <br> CustomAttribute15 <br> ExtensionCustomAttribute1 <br> ExtensionCustomAttribute2 <br> ExtensionCustomAttribute3 <br> ExtensionCustomAttribute4 <br> ExtensionCustomAttribute5|
131112
|**MailboxMove**|MailboxMoveBatchName <br> MailboxMoveFlags <br> MailboxMoveRemoteHostName <br> MailboxMoveSourceMDB <br> MailboxMoveStatus <br> MailboxMoveTargetMDB|
132113
|**Policy**|ActiveSyncMailboxPolicy <br> ActiveSyncMailboxPolicyIsDefaulted <br> AddressBookPolicy <br> EmailAddressPolicyEnabled <br> ManagedFolderMailboxPolicy <br> OwaMailboxPolicy <br> PoliciesExcluded <br> PoliciesIncluded <br> RetentionPolicy <br> SharingPolicy <br> ShouldUseDefaultRetentionPolicy <br> UMMailboxPolicy|
133-
|
134114

135115
**Note**: The following **Get-Recipient** parameters aren't available on **Get-EXORecipient**:
136116

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ description: "Learn how to use the Exchange Online PowerShell V2 module to conne
2020

2121
The Exchange Online PowerShell V2 module (abbreviated as the EXO V2 module) uses modern authentication and works with multi-factor authentication (MFA) for connecting to all Exchange-related PowerShell environments in Microsoft 365: Exchange Online PowerShell, Security & Compliance PowerShell, and standalone Exchange Online Protection (EOP) PowerShell. For more information about the EXO V2 module, see [About the Exchange Online PowerShell V2 module](exchange-online-powershell-v2.md).
2222

23-
**This article contains instructions for how to connect to Exchange Online PowerShell using the EXO V2 module with or without MFA.**
23+
This article contains instructions for how to connect to Exchange Online PowerShell using the EXO V2 module with or without MFA.
2424

2525
To use the older, less secure remote PowerShell connection instructions that [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163), see [Basic auth - Connect to Exchange Online PowerShell](basic-auth-connect-to-exo-powershell.md).
2626

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ description: "Learn how to use the Exchange Online PowerShell V2 module to conne
2020

2121
The Exchange Online PowerShell V2 module (abbreviated as the EXO V2 module) uses modern authentication and works with multi-factor authentication (MFA) for connecting to all Exchange-related PowerShell environments in Microsoft 365: Exchange Online PowerShell, Security & Compliance PowerShell, and standalone Exchange Online Protection (EOP) PowerShell. For more information about the EXO V2 module, see [About the Exchange Online PowerShell V2 module](exchange-online-powershell-v2.md).
2222

23-
**This article contains instructions for how to connect to Exchange Online Protection PowerShell using the EXO V2 module with or without using MFA.**
23+
This article contains instructions for how to connect to Exchange Online Protection PowerShell using the EXO V2 module with or without using MFA.
2424

2525
To use the older, less secure remote PowerShell connection instructions that [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163), see [Basic auth - Connect to Exchange Online Protection PowerShell](basic-auth-connect-to-eop-powershell.md).
2626

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ description: "Learn how to use the Exchange Online PowerShell V2 module to conne
2020

2121
The Exchange Online PowerShell V2 module (abbreviated as the EXO V2 module) uses modern authentication and works with multi-factor authentication (MFA) for connecting to all Exchange-related PowerShell environments in Microsoft 365: Exchange Online PowerShell, Security & Compliance PowerShell, and standalone Exchange Online Protection (EOP) PowerShell. For more information about the EXO V2 module, see [About the Exchange Online PowerShell V2 module](exchange-online-powershell-v2.md).
2222

23-
**This article contains instructions for how to connect to Security & Compliance Center PowerShell using the EXO V2 module with or without MFA.**
23+
This article contains instructions for how to connect to Security & Compliance Center PowerShell using the EXO V2 module with or without MFA.
2424

2525
To use the older, less secure remote PowerShell connection instructions that [will eventually be deprecated](https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-and-exchange-online-july-update/ba-p/1530163), see [Basic auth - Connect to Security & Compliance Center PowerShell](basic-auth-connect-to-scc-powershell.md).
2626

exchange/docs-conceptual/exchange-cmdlet-syntax.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -27,17 +27,12 @@ This article explains these conventions, and also the syntax that's required to
2727

2828
Exchange PowerShell help follows conventions that indicate what's required or optional, and how to enter parameters and values when you run a command. These command conventions are listed in the following table.
2929

30-
<br>
31-
32-
****
33-
3430
|Symbol|Description|
3531
|---|---|
3632
|`-`|A hyphen indicates a parameter. For example, `-Identity`.|
3733
|`< >`|Angle brackets indicate the possible values for a parameter. For example, `-Location <ServerName>` or -Enabled \<$true \| $false\>.|
3834
|`[ ]`|Square brackets indicate optional parameters and their values. For example, `[-WhatIf]` or `[-ResultSize <Unlimited>]`. <p> Parameter-value pairs that aren't enclosed in square brackets are required. For example, `-Password <SecureString>`. <p> If the parameter name itself is enclosed in square brackets, that indicates the parameter is a _positional_ parameter (you can use the parameter value without specifying the parameter), and positional parameters can be required or optional. <p> For example, `Get-Mailbox [[-Identity] <MailboxIdParameter>]` means the _Identity_ parameter is positional (because it's enclosed in square brackets) and optional (because the whole parameter-value pair is enclosed in square brackets), so you can use `Get-Mailbox -Identity <MailboxIdParameter>` or `Get-Mailbox <MailboxIdParameter>`. Similarly, `Set-Mailbox [-Identity] <MailboxIdParameter>` means the _Identity_ parameter is positional (because it's enclosed in square brackets) and required (because the whole parameter-value pair is not enclosed in square brackets), so you can use `Set-Mailbox -Identity <MailboxIdParameter>` or `Set-Mailbox <MailboxIdParameter>`.|
3935
|`|`|Pipe symbols in parameter values indicate a choice between values. For example, -Enabled \<$true \| $false\> indicates the _Enabled_ parameter can have the value `$true` or `$false`.|
40-
|
4136

4237
These command conventions help you understand how a command is constructed. With the exception of the hyphen that indicates a parameter, you don't use these symbols as they're described in the table when you run cmdlets in Exchange PowerShell.
4338

@@ -111,10 +106,6 @@ If you enclose the string in single quotation marks, the only special character
111106

112107
The following table shows the valid operators that you can use in an Exchange command. Some of these symbols were also described in the earlier [Command conventions in Exchange PowerShell](#command-conventions-in-exchange-powershell) section. However, these symbols have different meanings when they're used on the command line as operators. For example, the minus sign that's used to indicate a parameter can also be used in a command as a mathematical operator.
113108

114-
<br>
115-
116-
****
117-
118109
|Operator|Description|
119110
|---|---|
120111
|`=`|The equal sign is used as an assignment character. The value on the right side of the equal sign is assigned to the variable on the left side of the equal sign. The following characters are also assignment characters: <ul><li>`+=`: Add the value on the right side of the equal sign to the current value that's contained in the variable on the left side of the equal sign.</li><li>`-=`: Subtract the value on the right side of the equal sign from the current value that's contained in the variable on the left side of the equal sign.</li><li>`*=`: Multiply the current value of the variable on the left side of the equal sign by the value that's specified on the right side of the equal sign.</li><li>`/=`: Divide the current value of the variable on the left side of the equal sign by the value that's specified on the right side of the equal sign.</li><li> `%=`: Modify the current value of the variable on the left side of the equal sign by the value that's specified on the right side of the equal sign.</li></ul>|
@@ -136,4 +127,3 @@ The following table shows the valid operators that you can use in an Exchange co
136127
|`/`|A forward slash divides one value by another. For example, `6 / 6` equals `1`.|
137128
|`%`|The percent sign has the following uses: <ul><li>In a numerical evaluation, it returns the remainder from a division operator. For example, `6 % 4` equals `2`.</li><li>In a [pipeline](/powershell/module/microsoft.powershell.core/about/about_pipelines), it's shorthand for the **ForEach-Object** cmdlet. For example, `Import-Csv C:\MyFile.csv | ForEach-Object {Set-Mailbox $_.Identity -Name $_.Name}` is the same as `Import-Csv C:\MyFile.csv | % {Set-Mailbox $_.Identity -Name $_.Name}`.</li></ul>|
138129
|`?`|The question mark character is shorthand for the **Where-Object** cmdlet. For example, `Get-Alias | Where-Object {$_.Definition -eq "Clear-Host"}` is the same as `Get-Alias | ? {$_.Definition -eq "Clear-Host"}`.|
139-
|

exchange/docs-conceptual/exchange-management-shell.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,8 +72,6 @@ For more information about Edge Transport servers, see [Edge Transport Servers](
7272

7373
The following table provides links to articles that can help you learn about and use the Exchange Management Shell.
7474

75-
****
76-
7775
|Article|Description|
7876
|---|---|
7977
|[Open the Exchange Management Shell](open-the-exchange-management-shell.md)|Find and open the Exchange Management Shell on an Exchange server or a computer that has the Exchange management tools installed.|
@@ -83,4 +81,3 @@ The following table provides links to articles that can help you learn about and
8381
|[Exchange cmdlet syntax](exchange-cmdlet-syntax.md)|Learn about the structure and syntax of cmdlets in Exchange PowerShell.|
8482
|[Recipient filters in Exchange Management Shell commands](recipient-filters.md)|Learn about recipient filters in the Exchange Management Shell.|
8583
|[Use Update-ExchangeHelp to update Exchange PowerShell help articles on Exchange servers](use-update-exchangehelp.md)|Learn how to use Update-ExchangeHelp to update help for Exchange cmdlet reference articles on Exchange servers.|
86-
|

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

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,6 @@ The Exchange Online cmdlets in the EXO V2 module are meant to replace their olde
5050

5151
The improved Exchange Online PowerShell cmdlets that are only available in the EXO V2 module are listed in the following table:
5252

53-
<br>
54-
55-
****
56-
5753
|EXO V2 module cmdlet|Older related cmdlet|
5854
|---|---|
5955
|[Get-EXOMailbox](/powershell/module/exchange/get-exomailbox)|[Get-Mailbox](/powershell/module/exchange/get-mailbox)|
@@ -65,27 +61,17 @@ The improved Exchange Online PowerShell cmdlets that are only available in the E
6561
|[Get-EXOMailboxFolderStatistics](/powershell/module/exchange/get-exomailboxfolderstatistics)|[Get-MailboxFolderStatistics](/powershell/module/exchange/get-mailboxfolderstatistics)|
6662
|[Get-EXOMailboxFolderPermission](/powershell/module/exchange/get-exomailboxfolderpermission)|[Get-MailboxFolderPermission](/powershell/module/exchange/get-mailboxfolderpermission)|
6763
|[Get-EXOMobileDeviceStatistics](/powershell/module/exchange/get-exomobiledevicestatistics)|[Get-MobileDeviceStatistics](/powershell/module/exchange/get-mobiledevicestatistics)|
68-
|
6964

7065
The connection-related cmdlets that are available in the EXO V2 module are listed in the following table:
7166

72-
<br>
73-
74-
****
75-
7667
|EXO V2 module cmdlet|Older related cmdlet|
7768
|---|---|
7869
|[Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline)|[Connect-EXOPSSession](v1-module-mfa-connect-to-exo-powershell.md) <p> or <p> [New-PSSession](/powershell/module/microsoft.powershell.core/new-pssession)|
7970
|[Connect-IPPSSession](/powershell/module/exchange/connect-ippssession)|[Connect-IPPSSession](v1-module-mfa-connect-to-scc-powershell.md)|
8071
|[Disconnect-ExchangeOnline](/powershell/module/exchange/disconnect-exchangeonline)|[Remove-PSSession](/powershell/module/microsoft.powershell.core/remove-pssession)|
81-
|
8272

8373
Miscellaneous Exchange Online cmdlets that happen to be in the EXO V2 module are listed in the following table:
8474

85-
<br>
86-
87-
****
88-
8975
|EXO V2 module cmdlet|Comments|
9076
|---|---|
9177
|[Get-MyAnalyticsFeatureConfig](/powershell/module/exchange/get-myanalyticsfeatureconfig)|Available in v2.0.4 or later.|
@@ -94,7 +80,6 @@ Miscellaneous Exchange Online cmdlets that happen to be in the EXO V2 module are
9480
|[Set-UserBriefingConfig](/powershell/module/exchange/set-userbriefingconfig)|Replaced by [Set-MyAnalyticsFeatureConfig](/powershell/module/exchange/set-myanalyticsfeatureconfig).|
9581
|[Get-VivaInsightsSettings](/powershell/module/exchange/get-vivainsightssettings)|Available in v2.0.5-Preview2 or later.|
9682
|[Set-VivaInsightsSettings](/powershell/module/exchange/set-vivainsightssettings)|Available in v2.0.5-Preview2 or later.|
97-
|
9883

9984
### Updates for version 2.0.6
10085

0 commit comments

Comments
 (0)