Commands › Microsoft Teams

Set-CsTeamsAcsFederationConfiguration

Microsoft Teams MicrosoftTeams Set-*

This cmdlet is used to manage the federation configuration between Teams and Azure Communication Services. For more information, please see Azure Communication Services and Teams Interoperability.

Quick start script

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

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

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

Syntax

Set-CsTeamsAcsFederationConfiguration
 [-Identity <String[]>]
 [-EnableAcsUsers <Boolean>]
 [-AllowedAcsResources <String[]>]
 [-RequireAcsFederationForMeeting <Boolean>]
 [-LabelForAllowedAcsUsers <String>]
 [-HideBannerForAllowedAcsUsers <Boolean>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Parameters (6)

Parameter	Type	What it controls
-AllowedAcsResources	String[]	The list of the ACS resources (at least one) for which federation is enabled, when EnableAcsUsers is set to true. If EnableAcsUsers is set to false, then this list is ignored and should be null/empty.
-EnableAcsUsers	Boolean	Set to True to enable federation between Teams and ACS. When set to False, all other parameters are ignored.
-HideBannerForAllowedAcsUsers	Boolean	This configuration controls the display of the 'limited call features' banner for Azure Communication Services users participating in Teams meetings or calls. Possible values are: True, False. Set to True to hide the...
-Identity	String	Specifies the collection of tenant federation configuration settings to be modified. Because each tenant is limited to a single, global collection of federation settings there is no need include this parameter when...
-LabelForAllowedAcsUsers	String	This configuration controls the user label that is displayed for Azure Communication Services users when they join Teams meetings or calls. Possible values are: Unverified, External. When the value is set to...
-RequireAcsFederationForMeeting	Boolean	This configuration controls whether ACS Federation is required for meetings. Possible values are: True, False.

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