Get-CsTeamsFilesPolicy

Module:

MicrosoftTeamsPowerShell

Use the `Get-CsTeamsFilesPolicy` cmdlet to get a list of all pre-configured policy instances related to teams files.

Syntax

Get-CsTeamsFilesPolicy
   [[-Identity] <String>]
   [<CommonParameters>]

Get-CsTeamsFilesPolicy
   [-Filter <String>]
   [<CommonParameters>]

Description

This cmdlet retrieves information about one or more teams files policies that have been configured for use in your organization. teams files policies are used by the organization to manage files-related features such as third party storage provider for files from teams.

Examples

Example 1

Get-CsTeamsFilesPolicy

In Example 1, the Get-CsTeamsFilesPolicy cmdlet is called without any additional parameters; this returns a collection of all the teams files policies configured for use in your organization.

Example 2

Get-CsTeamsFilesPolicy -Identity TranscriptionDisabled

In Example 2, the Get-CsTeamsFilesPolicy cmdlet is used to return the per-user teams files policy that has an Identity TranscriptionDisabled. Because identities are unique, this command will never return more than one item.

Example 3

Get-CsTeamsFilesPolicy -Filter "tag:*"

Example 3 uses the Filter parameter to return all the teams files policies that have been configured at the per-user scope. The filter value "tag:*" tells the Get-CsTeamsFilesPolicy cmdlet to return only those policies that have an Identity that begins with the string value "tag:".

Parameters

-Filter

This parameter accepts a wildcard string and returns all teams files policies with identities matching that string. For example, a Filter value of Tag:* will return all preconfigured teams files policy instances (excluding forest default "Global") available to use by the tenant admins.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

A unique identifier specifying the scope, and in some cases the name, of the policy. If this parameter is omitted, all teams files policies available for use are returned.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

System.Object