Commands › Microsoft Teams

Set-CsTeamsMobilityPolicy

Microsoft Teams MicrosoftTeams Set-*

The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users.

Quick start script

# Set-CsTeamsMobilityPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsMobilityPolicy
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTeamsMobilityPolicy  -WhatIf
Set-CsTeamsMobilityPolicy

# 4. Verify and diff
$after = Get-CsTeamsMobilityPolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 2 parameter sets

Identity (Default)

Set-CsTeamsMobilityPolicy [-Tenant <System.Guid>] [-Description <String>] [-IPVideoMobileMode <String>]
 [-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>] [-LinksInTeams <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (9)

ParameterTypeRequiredWhat it controls
-Confirm SwitchParameter Prompts you for confirmation before running the cmdlet.
-Description String Enables administrators to provide explanatory text about the policy. For example, the Description might indicate the users the policy should be assigned to.
-Force SwitchParameter Bypasses all non-fatal errors.
-Identity XdsIdentity Specify the name of the policy that you are creating.
-IPAudioMobileMode String When set to WifiOnly, prohibits the user from making, receiving calls or joining meetings using VoIP calls on the mobile device while on cellular data connection.
-IPVideoMobileMode String When set to WifiOnly, prohibits the user from making, receiving video calls or enabling video in meetings using VoIP calls on the mobile device while on cellular data connection.
-MobileDialerPreference String Determines the mobile dialer preference, possible values are: Teams, Native, UserOverride. For more information, see [Manage user incoming calling...
-LinksInTeams String 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...
-WhatIf SwitchParameter Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.