Remove-MapiPermission

Description

This cmdlet removes one or more permissions on a MAPI folder, for message stores that support permissions.

Syntax
Note: Parameters in orange are optional.
Remove-MapiPermission
-FolderMapiObject<Mapi.NET.Folder>
-UserOrGroupIDsMapi.NET.EntryID[]
Remove-MapiPermission
-FolderMapiObject<Mapi.NET.Folder>
-UserOrGroupAddressesString[]
Parameters
FolderA Mapi.NET.Folder from which permissions are removed.
UserOrGroupIDsA list of one or more EntryID values each representing a permission to be removed from the folder.
UserOrGroupAddressesA list of one or more email addresses that can be resolved to Address Book users and which will have permissions removed from the folder.
Remarks

This cmdlet removes permissions from a folder.  

Not all message stores support folder permissions.  For example, PST files do not provide an ability to set folder permissions and attempts to use this cmdlet on folder in a PST will fail.

Only permissions that exist on Folder and match either the EntryID or address values provided will be removed.  If an EntryID or address is provided, but for which the folder does not have a permission, that value is ignored.