Edit

Share via

New-CsApplicationAccessPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

Creates a new application access policy. Application access policy contains a list of application (client) IDs. When granted to a user, those applications will be authorized to access online meetings on behalf of that user.

Syntax

New-CsApplicationAccessPolicy
   [-Identity <XdsIdentity>]
   [-AppIds <PSListModifier>]
   [-Description <String>]
   [<CommonParameters>]

Description

This cmdlet creates a new application access policy. Application access policy contains a list of application (client) IDs. When granted to a user, those applications will be authorized to access online meetings on behalf of that user.

Examples

Create a new application access policy with one app ID

PS C:\> New-CsApplicationAccessPolicy -Identity "ASimplePolicy" -AppIds "d39597bf-8407-40ca-92ef-1ec26b885b7b" -Description "Some description"

The command shown above shows how to create a new policy with one app IDs configured.

Create a new application access policy with multiple app IDs

PS C:\> New-CsApplicationAccessPolicy -Identity "ASimplePolicy" -AppIds "d39597bf-8407-40ca-92ef-1ec26b885b71", "57caaef9-5ed0-48d5-8862-e5abfa71b3e1", "dc17674c-81d9-4adb-bfb2-8f6a442e4620" -Description "Some description"

The command shown above shows how to create a new policy with a list of (three) app IDs configured.

Parameters

-AppIds

A list of application (client) IDs. For details of application (client) ID, refer to: Get tenant and app ID values for signing in.

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

-Description

Specifies the description of the policy.

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

-Identity

Unique identifier assigned to the policy when it was created.

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