diff --git a/exchange/docs-conceptual/exchange-online-powershell-v2.md b/exchange/docs-conceptual/exchange-online-powershell-v2.md index bfc52fb02c..baaae755ae 100644 --- a/exchange/docs-conceptual/exchange-online-powershell-v2.md +++ b/exchange/docs-conceptual/exchange-online-powershell-v2.md @@ -701,9 +701,15 @@ Unless otherwise noted, the current release of the Exchange Online PowerShell mo ### Current release +#### Version 3.9.0 + +- New _EnableSearchOnlySession_ switch on **Connect-IPPSSession**, which enables certain eDiscovery cmdlets and related cmdlets that connect to other Microsoft 365 services. + +### Previous releases + #### Version 3.8.0 -- Support for providing an access token with **Connect-IPPSSession**. +- New _AccessToken_ parameter on **Connect-IPPSSession**. - **Get-VivaModuleFeature** now returns information about ParentFeature, ChildFeature, and PolicyModes. These values represent parent and child features of a Viva app feature along with available enablement modes for future policies. - New parameters _IsUserOptedInByDefault_ on the **Add-VivaModuleFeaturePolicy** and **Update-VivaModuleFeaturePolicy** cmdlets and the corresponding property value in all **\*-VivaModuleFeaturePolicy** cmdlets. The value indicates if users are opted in or out by the policy, as long as the user doesn't set a preference. @@ -711,8 +717,6 @@ Unless otherwise noted, the current release of the Exchange Online PowerShell mo - Deprecated the **Get-VivaFeatureCategory** cmdlet, all category-related parameters, and return values (_CategoryId_, _IsCategoryEnabled_). -### Previous releases - #### Version 3.7.2 - The _DisableWAM_ switch is available on the **Connect-ExchangeOnline** cmdlet to disable Web Account Manager (WAM) if you get WAM-related connection errors. diff --git a/exchange/docs-conceptual/whats-new-in-the-exo-module.md b/exchange/docs-conceptual/whats-new-in-the-exo-module.md index 78d31d9b2e..460b7ed7c6 100644 --- a/exchange/docs-conceptual/whats-new-in-the-exo-module.md +++ b/exchange/docs-conceptual/whats-new-in-the-exo-module.md @@ -22,11 +22,17 @@ description: "Learn about the new features and functionality available in the la This article lists new features in the Exchange Online PowerShell module used for connecting to Exchange Online PowerShell, Security & Compliance PowerShell, and Exchange Online Protection PowerShell for cloud protection of on-premises email environments. Features that are currently in preview are denoted with **(preview)**. +## August 2025 + +- [Version 3.9.0](https://www.powershellgallery.com/packages/ExchangeOnlineManagement/3.9.0) + + For information about what's in this release, see [Version 3.9.0](exchange-online-powershell-v2.md#version-390). + ## May 2025 - [Version 3.8.0](https://www.powershellgallery.com/packages/ExchangeOnlineManagement/3.8.0) - - For information about what's in this release, see [Version 3.8.0](exchange-online-powershell-v2.md#version-380). + For information about what's in this release, see [Version 3.8.0](exchange-online-powershell-v2.md#version-380). ## March 2025 diff --git a/exchange/exchange-ps/ExchangePowerShell/Add-VivaModuleFeaturePolicy.md b/exchange/exchange-ps/ExchangePowerShell/Add-VivaModuleFeaturePolicy.md index 11f17402bd..888cfe77b9 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Add-VivaModuleFeaturePolicy.md +++ b/exchange/exchange-ps/ExchangePowerShell/Add-VivaModuleFeaturePolicy.md @@ -244,7 +244,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.3.0 or later. +**Note**: This parameter is available in module version 3.3.0-Preview1 or later. The IsUserControlEnabled parameter specifies whether user control is enabled by the policy. Valid values are: diff --git a/exchange/exchange-ps/ExchangePowerShell/Connect-ExchangeOnline.md b/exchange/exchange-ps/ExchangePowerShell/Connect-ExchangeOnline.md index 041fb07970..148da03972 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Connect-ExchangeOnline.md +++ b/exchange/exchange-ps/ExchangePowerShell/Connect-ExchangeOnline.md @@ -294,7 +294,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.1.0 or later. +**Note**: This parameter is available in module version 3.1.0-Preview1 or later. The AccessToken parameter specifies the OAuth JSON Web Token (JWT) that's used to connect to Exchange Online. @@ -474,7 +474,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 2.0.4 or later, and only in PowerShell 7. +**Note**: This parameter is available in module version 2.0.4-Preview6 or later, and only in PowerShell 7. The Device switch is typically used on computers without web browsers. You don't need to specify a value with this switch. @@ -538,7 +538,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 2.0.4 or later, and only in PowerShell 7. +**Note**: This parameter is available in module version 2.0.4-Preview6 or later, and only in PowerShell 7. The InlineCredential switch specifies whether to pass credentials directly in the Windows PowerShell window. You don't need to specify a value with this switch. @@ -759,7 +759,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.2.0 or later. +**Note**: This parameter is available in module version 3.2.0-Preview4 or later. The SigningCertificate parameter specifies the client certificate that's used to sign the format files (\*.Format.ps1xml) or script module files (.psm1) in the temporary module that Connect-ExchangeOnline creates. @@ -783,7 +783,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.3.0 or later. +**Note**: This parameter is available in module version 3.3.0-Preview1 or later. In version 3.7.0-Preview1 or later, this parameter is replaced by the LoadCmdletHelp parameter. The SkipLoadingCmdletHelp parameter is no longer required and no longer does anything, because cmdlet help files are no longer downloaded by default. diff --git a/exchange/exchange-ps/ExchangePowerShell/Connect-IPPSSession.md b/exchange/exchange-ps/ExchangePowerShell/Connect-IPPSSession.md index 1ad6716131..7cd191ada3 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Connect-IPPSSession.md +++ b/exchange/exchange-ps/ExchangePowerShell/Connect-IPPSSession.md @@ -421,7 +421,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.7.2 or later. +**Note**: This parameter is available in module version 3.7.2-Preview1 or later. The DisableWAM switch disables Web Account Manager (WAM). You don't need to specify a value with this switch. @@ -443,7 +443,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.9.0-Preview1 or later. +**Note**: This parameter is available in module version 3.8.1-Preview1 or later. The EnableErrorReporting switch specifies whether to enable error reporting. You don't need to specify a value with this switch. @@ -483,7 +483,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.9.0-Preview1 or later. +**Note**: This parameter is available in module version 3.8.1-Preview1 or later. The LogDirectoryPath parameter specifies the location of the log files. The default location is `%TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv`. @@ -505,7 +505,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.9.0-Preview1 or later. +**Note**: This parameter is available in module version 3.8.1-Preview1 or later. The LogLevel parameter specifies the logging level. Valid values are Default and All. @@ -588,7 +588,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -This parameter is available in module version 3.2.0 or later. +**Note**: This parameter is available in module version 3.2.0-Preview3 or later. **Note**: Remote PowerShell connections to Security & Compliance PowerShell are deprecated. For more information, see [Deprecation of Remote PowerShell in Security and Compliance PowerShell](https://techcommunity.microsoft.com/t5/exchange-team-blog/deprecation-of-remote-powershell-rps-protocol-in-security-and/ba-p/3815432). diff --git a/exchange/exchange-ps/ExchangePowerShell/Disconnect-ExchangeOnline.md b/exchange/exchange-ps/ExchangePowerShell/Disconnect-ExchangeOnline.md index d57f5f5eae..086a7dc27b 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Disconnect-ExchangeOnline.md +++ b/exchange/exchange-ps/ExchangePowerShell/Disconnect-ExchangeOnline.md @@ -109,7 +109,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.2.0 or later. +**Note**: This parameter is available in module version 3.2.0-Preview2 or later. The ConnectionId parameter specifies the REST API connections to disconnect by ConnectionId. ConnectionId is a GUID value in the output of the Get-ConnectionInformation cmdlet that uniquely identifies a connection, even if you have multiple connections open. You can specify multiple ConnectionId values separated by commas. @@ -131,7 +131,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.2.0 or later. +**Note**: This parameter is available in module version 3.2.0-Preview2 or later. The ModulePrefix parameter specifies the REST API connections to disconnect by ModulePrefix. When you use the Prefix parameter with the Connect-ExchangeOnline cmdlet, the specified text is added to the names of all Exchange Online cmdlets (for example, Get-InboundConnector becomes Get-ContosoInboundConnector). The ModulePrefix value is visible in the output of the Get-ConnectionInformation cmdlet. You can specify multiple ModulePrefix values separated by commas. diff --git a/exchange/exchange-ps/ExchangePowerShell/Get-ConnectionInformation.md b/exchange/exchange-ps/ExchangePowerShell/Get-ConnectionInformation.md index 7fb3b35cb4..f0e11ccdc4 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Get-ConnectionInformation.md +++ b/exchange/exchange-ps/ExchangePowerShell/Get-ConnectionInformation.md @@ -90,7 +90,7 @@ This example returns a list of active REST-based connections that are using the > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.2.0 or later. +**Note**: This parameter is available in module version 3.2.0-Preview2 or later. The ConnectionId parameter filters the connections by ConnectionId. ConnectionId is a GUID value in the output of the Get-ConnectionInformation cmdlet that uniquely identifies a connection, even if you have multiple connections open. You can specify multiple ConnectionId values separated by commas. @@ -112,7 +112,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.2.0 or later. +**Note**: This parameter is available in module version 3.2.0-Preview2 or later. The ModulePrefix parameter filters the connections by ModulePrefix. When you use the Prefix parameter with the Connect-ExchangeOnline cmdlet, the specified text is added to the names of all Exchange Online cmdlets (for example, Get-InboundConnector becomes Get-ContosoInboundConnector). The ModulePrefix value is visible in the output of the Get-ConnectionInformation cmdlet. You can specify multiple ModulePrefix values separated by commas. diff --git a/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeatureEnablement.md b/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeatureEnablement.md index 7a5b8c979a..b4bfc24316 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeatureEnablement.md +++ b/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeatureEnablement.md @@ -23,6 +23,7 @@ For information about the parameter sets in the Syntax section below, see [Excha ``` Get-VivaModuleFeatureEnablement -FeatureId -Identity -ModuleId + [-Detailed] [-ResultSize ] [] ``` @@ -57,9 +58,18 @@ Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Id This example returns the enablement state of the Reflection feature in Viva Insights for the **group@contoso.com** group. +### Example 3 +```powershell +Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed +``` + +This example returns the enablement state of the Reflection feature in Viva Insights for the **user@contoso.com** user. Response is enhanced to provide additional information about the policies that are driving the feature's enablement state ## PARAMETERS ### -FeatureId + +> Applicable: Exchange Online + The FeatureId parameter specifies the feature in the Viva module. To view details about the features in a Viva module that support feature access controls, refer to the Get-VivaModuleFeature cmdlet. The details provided by the Get-VivaModuleFeature cmdlet include the feature identifier. @@ -68,7 +78,6 @@ To view details about the features in a Viva module that support feature access Type: String Parameter Sets: (All) Aliases: -Type: Exchange Online Required: True Position: Named @@ -78,6 +87,9 @@ Accept wildcard characters: False ``` ### -Identity + +> Applicable: Exchange Online + The Identity parameter specifies the user principal name (UPN) of the user or the SMTP address (email address) of the group that you want to view the feature enablement status of. [Mail-enabled Microsoft Entra groups](https://docs.microsoft.com/graph/api/resources/groups-overview#group-types-in-azure-ad-and-microsoft-graph) are supported. @@ -86,7 +98,6 @@ The Identity parameter specifies the user principal name (UPN) of the user or th Type: String Parameter Sets: (All) Aliases: -Type: Exchange Online Required: True Position: Named @@ -96,13 +107,15 @@ Accept wildcard characters: False ``` ### -ModuleId + +> Applicable: Exchange Online + The ModuleId parameter specifies the Viva module. ```yaml Type: String Parameter Sets: (All) Aliases: -Type: Exchange Online Required: True Position: Named @@ -111,14 +124,38 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -Detailed + +> Applicable: Exchange Online + +**Note**: This parameter is available in module version 3.8.1-Preview1 or later. + +The Detailed switch enhances the output of the command by providing more comprehensive information. You don't need to specify a value with this switch. + +This switch returns detailed insights, including related policies and their effectiveness. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ResultSize + +> Applicable: Exchange Online + This parameter is reserved for internal Microsoft use. ```yaml Type: Unlimited Parameter Sets: (All) Aliases: -Type: Exchange Online Required: False Position: Named diff --git a/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeaturePolicy.md b/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeaturePolicy.md index 1be55bd86b..ad5e761ac4 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeaturePolicy.md +++ b/exchange/exchange-ps/ExchangePowerShell/Get-VivaModuleFeaturePolicy.md @@ -83,7 +83,7 @@ This example returns details about the policies for the Reflection feature in Vi Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com ``` -This example returns details about the policies for all features across all Viva modules that apply to the user with the email user1@contoso.com and the group with the email group1@contoso.com. +This example returns details about the policies for all features across all Viva modules that apply to the user with the email `user1@contoso.com` and the group with the email `group1@contoso.com`. ## PARAMETERS @@ -149,6 +149,8 @@ Accept wildcard characters: False > Applicable: Exchange Online +**Note**: This parameter is available in module version 3.8.1-Preview1 or later. + The MemberIds parameter specifies the specific users or groups for which you want to view the policies for the feature in the Viva module. You can provide up to three member IDs. Use the \* character to specify all modules or features. diff --git a/exchange/exchange-ps/ExchangePowerShell/Update-VivaModuleFeaturePolicy.md b/exchange/exchange-ps/ExchangePowerShell/Update-VivaModuleFeaturePolicy.md index 25b1d29a75..619147bc1e 100644 --- a/exchange/exchange-ps/ExchangePowerShell/Update-VivaModuleFeaturePolicy.md +++ b/exchange/exchange-ps/ExchangePowerShell/Update-VivaModuleFeaturePolicy.md @@ -265,7 +265,7 @@ Accept wildcard characters: False > Applicable: Exchange Online -**Note**: This parameter is available in module version 3.3.0 or later. If the feature supports user controls for opting out, be sure to set the *IsUserControlEnabled* parameter when you create the policy. Otherwise, user controls for the policy use the default state for the feature. +**Note**: This parameter is available in module version 3.3.0-Preview1 or later. If the feature supports user controls for opting out, be sure to set the *IsUserControlEnabled* parameter when you create the policy. Otherwise, user controls for the policy use the default state for the feature. The IsUserControlEnabled parameter specifies whether user control is enabled by the policy. Valid values are: