Get-CsTeamsAppPermissionPolicy

Module:

MicrosoftTeamsPowerShell

Applies to:

Microsoft Teams

NOTE: The existence of this cmdlet is being documented for completeness, but do not use this cmdlet. We require that all creation and modification of app permission polices (not including the assignment or removal of policies from users) happens in the Microsoft Teams & Skype for Business Admin Center to ensure that the policy matches your expectations for the end user experience. This cmdlet is not supported for tenants that migrated to app centric management feature as it replaced permission policies. While the cmdlet may succeed, the changes aren't applied to the tenant.

As an admin, you can use app permission policies to allow or block apps for your users. Learn more about the app permission policies at /microsoftteams/teams-app-permission-policies and about app centric management at /microsoftteams/app-centric-management.

Syntax

Get-CsTeamsAppPermissionPolicy
   [-Tenant <System.Guid>]
   [[-Identity] <XdsIdentity>]
   [-LocalStore]
   [<CommonParameters>]

Get-CsTeamsAppPermissionPolicy
   [-Tenant <System.Guid>]
   [-Filter <String>]
   [-LocalStore]
   [<CommonParameters>]

Description

NOTE: The existence of this cmdlet is being documented for completeness, but do not use this cmdlet. We require that all creation and modification of app permission polices (not including the assignment or removal of policies from users) happens in the Microsoft Teams & Skype for Business Admin Center to ensure that the policy matches your expectations for the end user experience.

As an admin, you can use app permission policies to enable or block specific apps for your users. Learn more about the App Setup Policies: /microsoftteams/teams-app-permission-policies.

Examples

Example 1

Get-CsTeamsAppPermissionPolicy -Identity Global

Identity               : Global
DefaultCatalogApps     : {Id=26bc2873-6023-480c-a11b-76b66605ce8c, Id=0d820ecd-def2-4297-adad-78056cde7c78, Id=com.microsoft.teamspace.tab.planner}
GlobalCatalogApps      : {}
PrivateCatalogApps     : {}
Description            :
DefaultCatalogAppsType : AllowedAppList
GlobalCatalogAppsType  : AllowedAppList
PrivateCatalogAppsType : AllowedAppList

Get the global Teams app permission policy.

Example 2

Get-CsTeamsAppPermissionPolicy

Identity               : Global
DefaultCatalogApps     : {Id=26bc2873-6023-480c-a11b-76b66605ce8c, Id=0d820ecd-def2-4297-adad-78056cde7c78, Id=com.microsoft.teamspace.tab.planner}
GlobalCatalogApps      : {}
PrivateCatalogApps     : {}
Description            :
DefaultCatalogAppsType : AllowedAppList
GlobalCatalogAppsType  : AllowedAppList
PrivateCatalogAppsType : AllowedAppList

Identity               : Tag:test
DefaultCatalogApps     : {Id=26bc2873-6023-480c-a11b-76b66605ce8c, Id=0d820ecd-def2-4297-adad-78056cde7c78, Id=com.microsoft.teamspace.tab.planner}
GlobalCatalogApps      : {}
PrivateCatalogApps     : {}
Description            :
DefaultCatalogAppsType : AllowedAppList
GlobalCatalogAppsType  : AllowedAppList
PrivateCatalogAppsType : AllowedAppList

Get all the Teams app permission policies.

Parameters

-Filter

Do not use

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

-Identity

Name of the app setup permission policy. If empty, all identities will be used by default.

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

-LocalStore

Do not use.

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

-Tenant

{{Fill Tenant Description}}

Type:	System.Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

System.Object