Get-CsTeamsAppPermissionPolicy
As an admin, you can use app permission policies to allow or block apps for your users.
Syntax
Identity (Default)
Get-CsTeamsAppPermissionPolicy
[[-Identity] <XdsIdentity>]
[-Tenant <System.Guid>]
[-LocalStore]
[<CommonParameters>]
Filter
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.
This is only applicable for tenants who have not been migrated to ACM or UAM.
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
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
Name of the app setup permission policy. If empty, all identities will be used by default.
Parameter properties
| Type: | XdsIdentity |
| 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 |
-LocalStore
Do not use.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Tenant
{{Fill Tenant Description}}
Parameter properties
| Type: | System.Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| 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.