Commands › Microsoft Teams

Set-CsTeamsAIPolicy

Microsoft Teams MicrosoftTeams Set-*

This cmdlet sets Teams AI policy value for users in the tenant.

Quick start script

# Set-CsTeamsAIPolicy — 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-CsTeamsAIPolicy
$before | Format-List

# 3. Make the change
Set-CsTeamsAIPolicy -EnrollFace <String> -EnrollVoice <String> -PassiveVoiceEnrollment <String>

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

Syntax

Set-CsTeamsAIPolicy [[-Identity] <string>]
 [-EnrollFace <string>]
 [-EnrollVoice <string>]
 [-PassiveVoiceEnrollment <string>]
 [-SpeakerAttributionBYOD <string>]
 [-Description <string>]
 [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Description	String		Enables administrators to provide explanatory text about the Teams AI policy. For example, the Description might indicate the users the policy should be assigned to.
-EnrollFace	String	yes	Policy value of the Teams AI EnrollFace policy. EnrollFace controls user access to user face enrollment in the Teams app settings.
-EnrollVoice	String	yes	Policy value of the Teams AI EnrollVoice policy. EnrollVoice controls user access to active voice enrollment in the Teams app settings.
-PassiveVoiceEnrollment	String	yes	Policy value of the Teams AI PassiveVoiceEnrollment policy. PassiveVoiceEnrollment controls user access to express voice enrollment in the Teams app settings.
-Identity	String	yes	Identity of the Teams AI policy.
-SpeakerAttributionBYOD	String	yes	Policy value of the Teams AI SpeakerAttributionBYOD policy. Setting to "Enabled" turns on speaker attribution in BYOD scenarios while "Disabled" will turn off the function.

Message Center changes mentioning this command

MC1197146 (Updated) Express voice enrollment in Microsoft Teams

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