Get-CsTeamsTemplatePermissionPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell

Fetches the TeamsTemplatePermissionPolicy. This policy can be used to hide Teams templates from users and groups.

Syntax

Get-CsTeamsTemplatePermissionPolicy
   [[-Identity] <String>]
   [<CommonParameters>]
Get-CsTeamsTemplatePermissionPolicy
   [-Filter <String>]
   [<CommonParameters>]

Description

Fetches the instances of the policy. Each policy object contains a property called HiddenTemplates.This array contains the list of Teams template IDs that will be hidden by that instance of the policy.

Examples

Example 1

PS >Get-CsTeamsTemplatePermissionPolicy

Identity                  HiddenTemplates                                                                           Description
--------                  ---------------                                                                           -----------
Global                    {com.microsoft.teams.template.CoordinateIncidentResponse}
Tag:Foobar                {com.microsoft.teams.template.ManageAProject, com.microsoft.teams.template.ManageAnEvent}

Fetches all the policy instances currently available.

Example 2

PS >Get-CsTeamsTemplatePermissionPolicy -Identity Foobar

Identity   HiddenTemplates                                                                           Description
--------   ---------------                                                                           -----------
Tag:Foobar {com.microsoft.teams.template.ManageAProject, com.microsoft.teams.template.ManageAnEvent}

Fetches an instance of a policy with known identity.

Example 3

PS >Get-CsTeamsTemplatePermissionPolicy -Filter *Foo*

Identity   HiddenTemplates                                                                           Description
--------   ---------------                                                                           -----------
Tag:Foobar {com.microsoft.teams.template.ManageAProject, com.microsoft.teams.template.ManageAnEvent}

The Filter parameter can be used to fetch policy instances based on partial matches on Identity.

Note: The "Tag:" prefix can be ignored when specifying the identity.

Parameters

-Filter

This parameter can be used to fetch policy instances based on partial matches on the Identity field.

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

-Identity

This parameter can be used to fetch a specific instance of the policy.

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

Inputs

None

Outputs

TeamsTemplatePermissionPolicy.Cmdlets.TeamsTemplatePermissionPolicy