Merge branch 'main' into teams-chrisda

chrisda · web-flow · commit 00eff7f57924 · 2026-02-10T13:47:48.000-08:00
diff --git a/exchange/exchange-ps/ExchangePowerShell/Add-AvailabilityAddressSpace.md b/exchange/exchange-ps/ExchangePowerShell/Add-AvailabilityAddressSpace.md
@@ -223,7 +223,7 @@ Accept wildcard characters: False
 
 This parameter is available only in the cloud-based service.
 
-The TargetServiceEpr parameter specifies the Exchange Online Calendar Service URL of the external Microsoft 365 organization that you're trying to read free/busy information from. Valid values are:
+The TargetServiceEpr parameter specifies the Exchange Online address of the external Microsoft 365 organization that you're trying to read free/busy information from. Valid values are:
 
 - Microsoft 365 or Microsoft 365 GCC: outlook.office.com
 - Office 365 operated by 21Vianet: partner.outlook.cn
diff --git a/exchange/exchange-ps/ExchangePowerShell/Set-Mailbox.md b/exchange/exchange-ps/ExchangePowerShell/Set-Mailbox.md
@@ -3391,7 +3391,8 @@ This switch doesn't remove the following types of holds:
 - eDiscovery holds (maintained for compliance).
 - Litigation holds (maintained for compliance).
 - Restrictive retention policies (preserved for compliance rules).
-- Policy configurations (doesn't update policy exclusion lists).
+
+ Policy configurations of Microsoft 365 retention policies is not updated (doesn't update exclusion lists).
 
 After you use this switch in a **Set-Mailbox** command on an inactive mailbox, run the following **Get-Mailbox** command to confirm the results:
 
@@ -3419,7 +3420,9 @@ Accept wildcard characters: False
 
 This parameter is available only in Exchange Online.
 
-The ExcludeFromAllOrgHolds switch excludes the mailbox from all organization-wide Microsoft 365 retention policies. This switch can only be used for inactive mailboxes. You don't need to specify a value with this switch.
+The ExcludeFromAllOrgHolds switch excludes the mailbox from all organization-wide Microsoft 365 Exchange retention policies. This switch can only be used for inactive mailboxes. You don't need to specify a value with this switch.
+
+This switch doesn't exclude the mailbox from App-Retention policies (including organization-wide).
 
 When you use this switch, use the DistinguishedName or ExchangeGuid property value for the identity of the inactive mailbox (those are the only values that guarantee uniqueness).
 
diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsWorkLocationDetectionPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsWorkLocationDetectionPolicy.md
@@ -28,8 +28,11 @@ Get-CsTeamsWorkLocationDetectionPolicy [-Filter <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Fetches instances of TeamsWorkLocationDetectionPolicy. Each policy object contains a property called `EnableWorkLocationDetection`. This setting allows your organization to collect the work location of users when they connect, interact, or are detected near your organization's networks and devices. It also captures the geographic location information users share from personal and mobile devices.
-This gives users the ability to consent to the use of this location data to set their current work location.Microsoft collects this information to provide users with a consistent location-based experience and to improve the hybrid work experience in Microsoft 365 according to the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839).
+Fetches instances of TeamsWorkLocationDetectionPolicy. Each policy object contains the following properties:
+
+- `EnableWorkLocationDetection`: This setting allows your organization to collect the work location of users when they connect, interact, or are detected near your organization's networks and devices. It also captures the geographic location information users share from personal and mobile devices. This gives users the ability to consent to the use of this location data to set their current work location. Microsoft collects this information to provide users with a consistent location-based experience and to improve the hybrid work experience in Microsoft 365 according to the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839).
+
+- `UserSettingsDefault`: Specifies the default user settings behavior for work location detection. Possible values are `Disabled` (default) and `Enabled`.
 
 ## EXAMPLES
 
@@ -38,11 +41,11 @@ This gives users the ability to consent to the use of this location data to set
 PS C:\> Get-CsTeamsWorkLocationDetectionPolicy
 ```
 ```output
-Identity            EnableWorkLocationDetection
---------                 ----------------------
-Global                                     False
-Tag:wld-policy1                            True
-Tag:wld-policy2                           False
+Identity            EnableWorkLocationDetection UserSettingsDefault
+--------            --------------------------- -------------------
+Global                                    False            Disabled
+Tag:wld-policy1                            True             Enabled
+Tag:wld-policy2                           False            Disabled
 ```
 Fetches all the policy instances currently available.
 
@@ -51,9 +54,9 @@ Fetches all the policy instances currently available.
 PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Identity wld-policy1
 ```
 ```output
-Identity            EnableWorkLocationDetection
---------                 ----------------------
-Tag:wld-policy1                            True
+Identity            EnableWorkLocationDetection UserSettingsDefault
+--------            --------------------------- -------------------
+Tag:wld-policy1                            True             Enabled
 ```
 Fetches an instance of a policy with a known identity.
 
@@ -62,10 +65,10 @@ Fetches an instance of a policy with a known identity.
 PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Filter *wld*
 ```
 ```output
-Identity            EnableWorkLocationDetection
---------                 ----------------------
-Tag:wld-policy1                            True
-Tag:wld-policy2                           False
+Identity            EnableWorkLocationDetection UserSettingsDefault
+--------            --------------------------- -------------------
+Tag:wld-policy1                            True             Enabled
+Tag:wld-policy2                           False            Disabled
 ```
 The `Filter` parameter can be used to fetch policy instances based on partial matches on Identity.
 
diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md
@@ -890,6 +890,9 @@ Use the `New-CsOnlineTelephoneNumberOrder` cmdlet to create a telephone number s
 ### [New-CsOnlineTelephoneNumberReleaseOrder](New-CsOnlineTelephoneNumberReleaseOrder.md)
 This cmdlet creates a request to release telephone numbers from Microsoft Teams telephone number management inventory.
 
+### [New-CsPhoneNumberUsageChangeOrder](New-CsPhoneNumberUsageChangeOrder.md)
+This cmdlet creates a request to change the TN usage.
+
 ### [New-CsOnlineTimeRange](New-CsOnlineTimeRange.md)
 The New-CsOnlineTimeRange cmdlet creates a new time range.
 
diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md
@@ -0,0 +1,97 @@
+---
+applicable: Microsoft Teams
+author: garciadaniel
+external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml
+Locale: en-US
+manager: roykuntz
+Module Name: MicrosoftTeams
+ms.author: garciadaniel
+ms.reviewer: garciadaniel
+online version: https://learn.microsoft.com/powershell/module/teams/new-csphonenumberusagechangeorder
+schema: 2.0.0
+title: New-CsPhoneNumberUsageChangeOrder
+---
+
+# New-CsPhoneNumberUsageChangeOrder
+
+## SYNOPSIS
+This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type).
+
+## SYNTAX
+
+```
+New-CsPhoneNumberUsageChangeOrder -TelephoneNumber <String[]> -Usage <String>
+```
+
+## DESCRIPTION
+This cmdlet creates a order to update the usage of the given phone numbers (e.g. from User Type to Service Type).
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber "+123456789" -Usage ServiceType
+```
+```output
+cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13
+```
+
+In this example, the telephone number "+123456789" would change to Service Type usage.
+
+### Example 2
+```powershell
+[string[]]$tns="+14255551234","+14255551233"
+PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber $tns -Usage ServiceType
+```
+```output
+cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13
+```
+
+In this example, the usage of the given list of telephone numbers is being updated to Service Type.
+
+## PARAMETERS
+
+### -TelephoneNumber
+Specifies the telephone number(s) to remove. The format can be with or without the prefixed +, but needs to include country code etc.
+
+```yaml
+Type: System.String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Usage
+Specifies the new usage type for the given telephone numbers.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.String
+
+### None
+
+## NOTES
+This cmdlet is available in Teams PowerShell module 7.5.0 or later.
+
+## RELATED LINKS
diff --git a/teams/teams-ps/MicrosoftTeams/New-CsTeamsMobilityPolicy.md b/teams/teams-ps/MicrosoftTeams/New-CsTeamsMobilityPolicy.md
@@ -19,7 +19,7 @@ The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users.
 
 ```
 New-CsTeamsMobilityPolicy [-Tenant <System.Guid>] [-Description <String>] [-IPVideoMobileMode <String>]
- [-IPAudioMobileMode <String>] [-Identity] <XdsIdentity>] [-MobileDialerPreference <String>] [-InMemory] [-Force] [-WhatIf] [-Confirm]
+ [-IPAudioMobileMode <String>] [-Identity] <XdsIdentity>] [-MobileDialerPreference <String>] [-LinksInTeams <String>] [-InMemory] [-Force] [-WhatIf] [-Confirm]
  [<CommonParameters>]
 ```
 
@@ -145,6 +145,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -LinksInTeams
+Controls the availability of browser choice options in Teams Mobile. When set to OfferBrowserOptions, users get two browser choice experiences: (1) browser options in the Teams Mobile settings page for configuring default preferences, and (2) browser options in the upsell card when tapping links. When set to UseUserDefaults, links open using the user's system default browser settings. Possible values are: OfferBrowserOptions, UseUserDefaults.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: OfferBrowserOptions
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -WhatIf
 Shows what would happen if the cmdlet runs.
 The cmdlet is not run.
diff --git a/teams/teams-ps/MicrosoftTeams/New-CsTeamsWorkLocationDetectionPolicy.md b/teams/teams-ps/MicrosoftTeams/New-CsTeamsWorkLocationDetectionPolicy.md
@@ -18,15 +18,18 @@ This cmdlet is used to create a new instance of the TeamsWorkLocationDetectionPo
 ## SYNTAX
 
 ```
-New-CsTeamsWorkLocationDetectionPolicy [-EnableWorkLocationDetection <Boolean>] [-Identity] <String> [-Force]
+New-CsTeamsWorkLocationDetectionPolicy [-EnableWorkLocationDetection <Boolean>] [-UserSettingsDefault <String>] [-Identity] <String> [-Force]
  [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Creates a new instance of the TeamsWorkLocationDetectionPolicy. This policy can be used to tailor the work location detection experience. The parameter `EnableWorkLocationDetection` allows your organization to collect the work location of users when they connect, interact, or are detected near your organization's networks and devices. It also captures the geographic location information users share from personal and mobile devices.
-This gives users the ability to consent to the use of this location data to set their current work location.Microsoft collects this information to provide users with a consistent location-based experience and to improve the hybrid work experience in Microsoft 365 according to the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839).
+Creates a new instance of the TeamsWorkLocationDetectionPolicy. This policy can be used to tailor the work location detection experience.
+
+- The parameter `EnableWorkLocationDetection` allows your organization to collect the work location of users when they connect, interact, or are detected near your organization's networks and devices. It also captures the geographic location information users share from personal and mobile devices. This gives users the ability to consent to the use of this location data to set their current work location. Microsoft collects this information to provide users with a consistent location-based experience and to improve the hybrid work experience in Microsoft 365 according to the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839).
+
+- The parameter `UserSettingsDefault` specifies the default user settings behavior for work location detection. Possible values are `Disabled` (default) and `Enabled`.
 
-The end user experience utilizing this policy has rolled out to the general public. You can see updates at [Microsoft 365 Roadmap | Microsoft 365](https://www.microsoft.com/en-us/microsoft-365/roadmap?msockid=287ab43847c06d0008cca05b46076c18&filters=&searchterms=automatically%2Cset%2Cwork%2Clocation%22https://www.microsoft.com/en-us/microsoft-365/roadmap?msockid=287ab43847c06d0008cca05b46076c18&filters=&searchterms=automatically%2cset%2cwork%2clocation%22) and to learn more on how to enable the end user experience, please see [Setting up Bookable Desks in Microsoft Teams - Microsoft Teams | Microsoft Learn.](https://learn.microsoft.com/microsoftteams/rooms/bookable-desks).
+The end user experience utilizing this policy has rolled out to the general public. You can see updates at [Microsoft 365 Roadmap | Microsoft 365](https://www.microsoft.com/en-us/microsoft-365/roadmap?msockid=287ab43847c06d0008cca05b46076c18&filters=&searchterms=automatically%2Cset%2Cwork%2Clocation) and to learn more on how to enable the end user experience, please see [Setting up Bookable Desks in Microsoft Teams - Microsoft Teams | Microsoft Learn.](https://learn.microsoft.com/microsoftteams/rooms/bookable-desks).
 
 ## EXAMPLES
 
@@ -35,22 +38,22 @@ The end user experience utilizing this policy has rolled out to the general publ
 PS C:\> New-CsTeamsWorkLocationDetectionPolicy -Identity wld-policy -EnableWorkLocationDetection $true
 ```
 ```output
-Identity                 EnableWorkLocationDetection
---------                 ----------------------
-Tag:wld-policy                            True
+Identity       EnableWorkLocationDetection UserSettingsDefault
+--------       --------------------------- -------------------
+Tag:wld-policy                        True            Disabled
 ```
-Creates a new policy instance with the identity wld-enabled. `EnableWorkLocationDetection` is set to the value specified in the command.
+Creates a new policy instance with the identity wld-policy. `EnableWorkLocationDetection` is set to the value specified in the command, and `UserSettingsDefault` defaults to `Disabled`.
 
 ### Example 2
 ```powershell
-PS C:\> New-CsTeamsWorkLocationDetectionPolicy -Identity wld-policy
+PS C:\> New-CsTeamsWorkLocationDetectionPolicy -Identity wld-policy -UserSettingsDefault Enabled
 ```
 ```output
-Identity                 EnableWorkLocationDetection
---------                 ----------------------
-Tag:wld-policy                            False
+Identity       EnableWorkLocationDetection UserSettingsDefault
+--------       --------------------------- -------------------
+Tag:wld-policy                       False             Enabled
 ```
-Creates a new policy instance with the identity wld-policy. `EnableWorkLocationDetection` will default to false if it is not specified.
+Creates a new policy instance with the identity wld-policy. `EnableWorkLocationDetection` defaults to `False` and `UserSettingsDefault` is set to `Enabled`.
 
 ## PARAMETERS
 
@@ -85,6 +88,26 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -UserSettingsDefault
+Specifies the default user settings behavior for work location detection. Possible values are:
+
+- `Enabled`: Enables the default user settings for work location detection.
+- `Disabled`: Disables the default user settings for work location detection.
+
+The default value is `Disabled`.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: Disabled
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Force
 Suppresses the display of any non-fatal error message that might arise when running the command.
 
diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsTeamsMessagingConfiguration.md b/teams/teams-ps/MicrosoftTeams/Set-CsTeamsMessagingConfiguration.md
@@ -140,7 +140,7 @@ Accept wildcard characters: False
 ### -FileTypeCheck
 
 > [!NOTE]
-> This parameter is in Private Preview.
+> This cmdlet is not available in GCC, GCCH and DOD.
 
 This setting enables weaponizable file detection in Teams messages in the tenant.
 
@@ -211,7 +211,7 @@ Accept wildcard characters: False
 ### -ReportIncorrectSecurityDetections
 
 > [!NOTE]
-> This parameter is in Private Preview.
+> This cmdlet is not available in GCC, GCCH and DOD.
 
 This setting enables the end users to Report incorrect security detections in Teams messages in the tenant.
 
@@ -234,7 +234,7 @@ Accept wildcard characters: False
 ### -UrlReputationCheck
 
 > [!NOTE]
-> This parameter is in Private Preview.
+> This cmdlet is not available in GCC, GCCH and DOD.
 
 This setting enables malicious URL detection in Teams messages in the tenant.
 
diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsTeamsMobilityPolicy.md b/teams/teams-ps/MicrosoftTeams/Set-CsTeamsMobilityPolicy.md
@@ -20,13 +20,13 @@ The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users.
 ### Identity (Default)
 ```
 Set-CsTeamsMobilityPolicy [-Tenant <System.Guid>] [-Description <String>] [-IPVideoMobileMode <String>]
- [-IPAudioMobileMode <String>] [[-Identity] <XdsIdentity>] [-MobileDialerPreference <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-IPAudioMobileMode <String>] [[-Identity] <XdsIdentity>] [-MobileDialerPreference <String>] [-LinksInTeams <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### Instance
 ```
 Set-CsTeamsMobilityPolicy [-Tenant <System.Guid>] [-Description <String>] [-IPVideoMobileMode <String>]
- [-IPAudioMobileMode <String>] [-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-IPAudioMobileMode <String>] [-Instance <PSObject>] [-LinksInTeams <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -38,7 +38,7 @@ The Set-CsTeamsMobilityPolicy cmdlet allows administrators to update teams mobil
 
 ### Example 1
 ```powershell
-PS C:\> Set-CsTeamsMobilityPolicy -Identity SalesPolicy -IPVideoMobileMode "WifiOnly
+PS C:\> Set-CsTeamsMobilityPolicy -Identity SalesPolicy -IPVideoMobileMode "WifiOnly"
 ```
 The command shown in Example 1 uses the Set-CsTeamsMobilityPolicy cmdlet to update an existing teams mobility policy with the Identity SalesPolicy. This SalesPolicy will not have IPVideoMobileMode equal to "WifiOnly".
 
@@ -149,6 +149,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -LinksInTeams
+Controls the availability of browser choice options in Teams Mobile. When set to OfferBrowserOptions, users get two browser choice experiences: (1) browser options in the Teams Mobile settings page for configuring default preferences, and (2) browser options in the upsell card when tapping links. When set to UseUserDefaults, links open using the user's system default browser settings. Possible values are: OfferBrowserOptions, UseUserDefaults.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+Required: False
+Position: Named
+Default value: OfferBrowserOptions
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -WhatIf
 Shows what would happen if the cmdlet runs.
 The cmdlet is not run.
diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsTeamsWorkLocationDetectionPolicy.md b/teams/teams-ps/MicrosoftTeams/Set-CsTeamsWorkLocationDetectionPolicy.md
