Upravit

Sdílet prostřednictvím

Set-CsTeamsAcsFederationConfiguration

  • Reference
Module:
MicrosoftTeamsPowerShell

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 $False

Example 2

In this example, federation is enabled for just one ACS resource.

$allowlist = @('faced04c-2ced-433d-90db-063e424b87b1')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist

Parameters

-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