Commands › Microsoft Teams

Set-CsTeamsFilesPolicy

Microsoft Teams MicrosoftTeams Set-*

Creates a new teams files policy. Teams files policies determine whether or not files entry points to SharePoint enabled for a user. The policies also specify third-party app ID to allow file storage (e.g., Box).

Quick start script

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

# 3. Make the change (dry run first)
Set-CsTeamsFilesPolicy -Identity <String> -WhatIf
Set-CsTeamsFilesPolicy -Identity <String>

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

Syntax

Set-CsTeamsFilesPolicy [-NativeFileEntryPoints <String>] [-SPChannelFilesTab <String>]
 [-DefaultFileUploadAppId <String>] [-FileSharingInChatswithExternalUsers <String>]
 [-Identity] <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (8)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before executing the command.
-DefaultFileUploadAppId	String		This can be used by the 3p apps to configure their app, so when the files will be dragged and dropped in compose, it will get uploaded in that 3P app.
-FileSharingInChatswithExternalUsers	String		Indicates if file sharing in chats with external users is enabled. It is by default disabled, to enable admins can run following command. ```powershell Set-CsTeamsFilesPolicy -Identity Global...
-Force	SwitchParameter		Suppresses the display of any non-fatal error message that might arise when running the command.
-Identity	String	yes	A unique identifier specifying the scope, and in some cases the name, of the policy.
-NativeFileEntryPoints	String		This parameter is enabled by default, which shows the option to upload content from ODSP to Teams chats or channels. . Possible values are Enabled or Disabled.
-SPChannelFilesTab	String		Indicates whether Iframe channel files tab is enabled, if not, integrated channel files tab will be enabled.
-WhatIf	SwitchParameter		Describes what would happen if you executed the command without actually executing the command.

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