Commands › Microsoft Teams

New-CsTeamsAIPolicy

Microsoft Teams MicrosoftTeams New-*

This cmdlet creates a Teams AI policy.

Quick start script

# New-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
New-CsTeamsAIPolicy -EnrollFace <String> -EnrollVoice <String> -Identity <String>

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

Syntax

New-CsTeamsAIPolicy -Identity <String>
 [-EnrollFace <string>]
 [-EnrollVoice <string>]
 [-SpeakerAttributionBYOD <string>]
 [-Description <string>]
 [<CommonParameters>]

Parameters (5)

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 user 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.

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