Set-CsApplicationAccessPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

Modifies an existing application access policy.

Syntax

Set-CsApplicationAccessPolicy
   [-AppIds <Object>]
   [-Description <String>]
   [[-Identity] <String>]
   [-MsftInternalProcessingMode <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

This cmdlet modifies an existing application access policy.

Examples

Add new app ID to the policy

PS C:\> Set-CsApplicationAccessPolicy -Identity "ASimplePolicy" -AppIds @{Add="5817674c-81d9-4adb-bfb2-8f6a442e4622"}

The command shown above adds a new app ID "5817674c-81d9-4adb-bfb2-8f6a442e4622" to the per-user application access policy ASimplePolicy.

Remove app IDs from the policy

PS C:\> Set-CsApplicationAccessPolicy -Identity "ASimplePolicy" -AppIds @{Remove="5817674c-81d9-4adb-bfb2-8f6a442e4622"}

The command shown above removes the app ID "5817674c-81d9-4adb-bfb2-8f6a442e4622" from the per-user application access policy ASimplePolicy.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-Description

Free format text.

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

-MsftInternalProcessingMode

For internal use only.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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