Commands › Microsoft Teams

New-CsTeamsFilesPolicy

Microsoft Teams MicrosoftTeams New-*

Creates a new teams files policy.

Quick start script

# New-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)
New-CsTeamsFilesPolicy -Identity <String> -WhatIf
New-CsTeamsFilesPolicy -Identity <String>

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

Syntax

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

Parameters (7)

Parameter	Type	Required	What it controls
-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		Shows what would happen if the cmdlet runs. The cmdlet is not run.

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