Set-CsTeamsClientConfiguration — usage, script and reference

Quick start script

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

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

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

Syntax — 2 parameter sets

Identity (Default)

Set-CsTeamsClientConfiguration [-Tenant <System.Guid>] [-AllowEmailIntoChannel <Boolean>]
 [-RestrictedSenderList <String>] [-AllowDropBox <Boolean>] [-AllowEgnyte <Boolean>] [-AllowBox <Boolean>] [-AllowGoogleDrive <Boolean>] [-AllowRoleBasedChatPermissions <Boolean>]
 [-AllowShareFile <Boolean>] [-AllowOrganizationTab <Boolean>] [-AllowSkypeBusinessInterop <Boolean>]
 [-AllowTBotProactiveMessaging <Boolean>] [-ContentPin <String>] [-AllowResourceAccountSendMessage <Boolean>]
 [-ResourceAccountContentAccess <String>] [-AllowGuestUser <Boolean>]
 [-AllowScopedPeopleSearchandAccess <Boolean>] [-UseUnifiedDomain <String>] [[-Identity] <XdsIdentity>] [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Instance

Set-CsTeamsClientConfiguration [-Tenant <System.Guid>] [-AllowEmailIntoChannel <Boolean>]
 [-RestrictedSenderList <String>] [-AllowDropBox <Boolean>] [-AllowEgnyte <Boolean>] [-AllowBox <Boolean>] [-AllowGoogleDrive <Boolean>] [-AllowRoleBasedChatPermissions <Boolean>]
 [-AllowShareFile <Boolean>] [-AllowOrganizationTab <Boolean>] [-AllowSkypeBusinessInterop <Boolean>]
 [-AllowTBotProactiveMessaging <Boolean>] [-ContentPin <String>] [-AllowResourceAccountSendMessage <Boolean>]
 [-ResourceAccountContentAccess <String>] [-AllowGuestUser <Boolean>]
 [-AllowScopedPeopleSearchandAccess <Boolean>] [-UseUnifiedDomain <String>] [-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Parameters (23)

Parameter	Type	What it controls
-AllowBox	Boolean	Designates whether users are able to leverage Box as a third party storage solution in Microsoft Teams. If $true, users will be able to add Box in the client and interact with the files stored there.
-AllowDropBox	Boolean	Designates whether users are able to leverage DropBox as a third party storage solution in Microsoft Teams. If $true, users will be able to add DropBox in the client and interact with the files stored there.
-AllowEgnyte	Boolean	Designates whether users are able to leverage Egnyte as a third party storage solution in Microsoft Teams. If $true, users will be able to add Egnyte in the client and interact with the files stored there.
-AllowEmailIntoChannel	Boolean	When set to $true, mail hooks are enabled, and users can post messages to a channel by sending an email to the email address of Teams channel.
-AllowGoogleDrive	Boolean	Designates whether users are able to leverage GoogleDrive as a third party storage solution in Microsoft Teams. If $true, users will be able to add Google Drive in the client and interact with the files stored there.
-AllowGuestUser	Boolean	Designates whether or not guest users in your organization will have access to the Teams client. If $true, guests in your tenant will be able to access the Teams client. Note that this setting has a core dependency...
-AllowOrganizationTab	Boolean	When set to $true, users will be able to see the organizational chart icon other users' contact cards, and when clicked, this icon will display the detailed organizational chart.
-AllowResourceAccountSendMessage	Boolean	Surface Hub uses a device account to provide email and collaboration services (IM, video, voice). This device account is used as the originating identity (the "from" party) when sending email, IM, and placing calls....
-AllowRoleBasedChatPermissions	Boolean	When set to True, Supervised Chat is enabled for the tenant.
-AllowScopedPeopleSearchandAccess	Boolean	If set to $true, the Exchange address book policy (ABP) will be used to provide customized view of the global address book for each user. This is only a virtual separation and not a legal separation.
-AllowShareFile	Boolean	Designates whether users are able to leverage Citrix ShareFile as a third party storage solution in Microsoft Teams. If $true, users will be able to add Citrix ShareFile in the client and interact with the files stored there.
-AllowSkypeBusinessInterop	Boolean	When set to $true, Teams conversations automatically show up in Skype for Business for users that aren't enabled for Teams.
-AllowTBotProactiveMessaging	Boolean	Deprecated, do not use.
-Confirm	SwitchParameter	Prompts you for confirmation before running the cmdlet.
-ContentPin	String	This setting applies only to Skype for Business Online (not Microsoft Teams) and defines whether the user must provide a secondary form of authentication to access the meeting content *from a resource device...
-Force	SwitchParameter	Bypass any verification checks and non-fatal errors.
-Identity	XdsIdentity	The only valid input is Global - the tenant wide configuration.
-Instance	PSObject	You can use this to pass the results from Get-CsTeamsClientConfiguration into the Set-CsTeamsClientConfiguration rather than specifying the "-Identity Global" parameter.
-ResourceAccountContentAccess	String	Require a secondary form of authentication to access meeting content.
-RestrictedSenderList	String	Senders domains can be further restricted to ensure that only allowed SMTP domains can send emails to the Teams channels. This is a semicolon-separated string of the domains you'd like to allow to send emails to...
-Tenant	Guid	Internal Microsoft use only.
-UseUnifiedDomain	String	This setting controls whether users are redirected from teams.microsoft.com to the unified domain teams.cloud.microsoft. Possible values are: - MicrosoftDefault, Microsoft will manage redirection behavior. If no...
-WhatIf	SwitchParameter	The WhatIf switch does not work with this cmdlet.