Get-CsTeamsAcsFederationConfiguration
This cmdlet is used to retrieve the federation configuration between Teams and Azure Communication Services.
Syntax
Default (Default)
Get-CsTeamsAcsFederationConfiguration
[-Identity <String[]>]
[-Filter <String>]
[<CommonParameters>]
Description
Federation between Teams and Azure Communication Services (ACS) allows users of custom solutions built with ACS to connect and communicate with Teams users over voice, video, Teams users over voice, video and screen sharing, and more. For more information, see Teams interoperability.
This cmdlet is used retrieve the Teams and ACS federation configuration for a Teams tenant.
You must be a Teams service admin or a Teams communication admin for your organization to run the cmdlet.
Examples
Example 1
PS C:\> Get-CsTeamsAcsFederationConfiguration
Identity : Global
AllowedAcsResources : {'faced04c-2ced-433d-90db-063e424b87b1'}
EnableAcsUsers : True
In this example, federation has been enabled for just one ACS resource.
Example 2
PS C:\> Get-CsTeamsAcsFederationConfiguration
Identity : Global
AllowedAcsResources : {}
EnableAcsUsers : False
In this example, federation is disabled for all ACS resources.
Parameters
-Filter
Enables you to use wildcards when specifying the Teams and ACS federation configuration settings to be returned. Because you can only have a single, global instance of these settings there is little reason to use the Filter parameter. However, if you prefer, you can use syntax similar to this to retrieve the global settings: -Identity "g*".
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Filter
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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"
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Identity
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.