Set-CsTeamsAcsFederationConfiguration
Limited Preview: Functionality described in this document is currently in limited preview and only authorized organizations have access. This preview version is provided without a service-level agreement, and is not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see Supplemental Terms of Use for Microsoft Azure Previews.
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.
Syntax
Set-CsTeamsAcsFederationConfiguration
[-Identity <String[]>]
[-EnableAcsUsers <Boolean>]
[-AllowedAcsResources <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Federation between Teams and Azure Communication Services (ACS) allows external users from ACS to connect and communicate with Teams users over voice and video. These custom applications may be used by end users or by bots, and there is no differentiation in how they appear to Teams users unless the developer of the application explicitly indicates this as part of the communication. For more information, see Teams interoperability.
This cmdlet is used to enable or disable Teams and ACS federation for a Teams tenant, and to specify which ACS resources can connect to Teams. Only listed ACS resources can be allowed.
You must be a Teams service admin or a Teams communication admin for your organization to run the cmdlet.
Examples
Example 1
In this example, federation between Teams and ACS is disabled completely.
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $FalseExample 2
In this example, federation is enabled for just one ACS resource.
$allowlist = @('faced04c-2ced-433d-90db-063e424b87b1')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlistParameters
-AllowedAcsResources
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.
The ACS resources are listed using their immutable resource id, which is a guid that can be found on the Azure portal.
| Type: | String[] |
| Position: | Named |
| Default value: | Empty/Null |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAcsUsers
Set to True to enable federation between Teams and ACS. When set to False, all other parameters are ignored.
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Identity
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 calling the Set-CsTenantFederationConfiguration cmdlet. If you do choose to use the Identity parameter, you must also include the Tenant parameter. For example:
Set-CsTenantFederationConfiguration -Tenant "bf19b7db-6960-41e5-a139-2aa373474354" -Identity "global"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |