Edit

Share via


Get-CsTeamsTemplatePermissionPolicy

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

Syntax

Identity (Default)

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

Filter

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identity
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

TeamsTemplatePermissionPolicy.Cmdlets.TeamsTemplatePermissionPolicy