Quick answer: To give someone access to one folder in a mailbox, run Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor. The folder goes after :\. Add creates a new entry; if the user already has one on that folder, change it with Set-MailboxFolderPermission instead.
What do Add- and Set-MailboxFolderPermission do?
They grant folder-level permissions, for example on the Calendar, Inbox or a custom folder, rather than the whole mailbox.
- Add-MailboxFolderPermission adds a new permission entry for a user.
- Set-MailboxFolderPermission modifies an existing entry. The rights you give replace the user's current rights on that folder.
- Remove-MailboxFolderPermission removes all of a user's permissions on the folder. See Remove-MailboxFolderPermission.
All three work in Exchange Server 2010 through Exchange Server SE and in Exchange Online. You need to be assigned permissions before you can run them. For access to the whole mailbox, use Add-MailboxPermission.
How do I connect first?
Exchange Online:
Install-Module -Name ExchangeOnlineManagement
Connect-ExchangeOnline -UserPrincipalName admin@contoso.com
See how to install the Exchange Online PowerShell module.
On-premises Exchange: open the Exchange Management Shell and run the same commands.
Examples
| Task | Command |
|---|---|
| Edit access to a calendar | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor |
| Read-only calendar access | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Reviewer |
| Free/busy plus subject and location | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights LimitedDetails |
| Read the Inbox | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Inbox -User ed@contoso.com -AccessRights Reviewer |
| Owner of a custom folder | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner |
| Calendar delegate (Exchange Online) | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User julia@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate |
| Delegate who sees private items | Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems |
| Send a sharing invitation too | Add -SendNotificationToUser $true (Exchange Online, calendar only) |
| Change existing access | Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Reviewer |
The Identity format is Mailbox:\Folder\Subfolder, for example john@contoso.com:\Calendar or John:\Inbox\Reports.
What are the AccessRights roles?
| Role | Permissions it includes |
|---|---|
| Owner | Create, read, edit and delete all items; create subfolders; FolderOwner and FolderContact |
| PublishingEditor | Create, read, edit and delete all items; create subfolders |
| Editor | Create, read, edit and delete all items |
| PublishingAuthor | Create and read items; edit and delete own items; create subfolders |
| Author | Create and read items; edit and delete own items |
| NonEditingAuthor | Create and read items; delete own items |
| Reviewer | Read items |
| Contributor | Create items and see the folder |
| AvailabilityOnly | Calendars only: free/busy |
| LimitedDetails | Calendars only: free/busy with subject and location |
| None | No access |
You can also give individual permissions instead of a role: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible and ReadItems. Separate several with commas.
How do calendar delegates work?
In Exchange Online, -SharingPermissionFlags makes someone a delegate. It only works on calendar folders with -AccessRights Editor.
- Delegate: the user receives meeting invites and responses for the mailbox.
- Delegate,CanViewPrivateItems: the same, plus private items. CanViewPrivateItems needs Delegate.
- None: no delegate access.
Editor without the Delegate flag still lets the user accept or decline a meeting by opening the request in the mailbox. See also adding delegates to resource mailboxes.
Watch out when changing a delegate with Set
With Set-MailboxFolderPermission, leaving out both -SendNotificationToUser and -SharingPermissionFlags keeps the user's delegate status. Using -SendNotificationToUser alone resets SharingPermissionFlags to None, which removes delegate access. To keep a delegate, pass -SharingPermissionFlags Delegate explicitly.
Who can be granted folder permissions?
-User accepts user mailboxes, mail users and mail-enabled security groups, including nested ones. Microsoft recommends a UPN (user@contoso.com) or domain\SamAccountName.
How do I check folder permissions?
Get-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar
This lists every entry on the folder with its AccessRights. In Exchange Online, Get-EXOMailboxFolderPermission does the same.
Troubleshooting
| Problem | Fix |
|---|---|
| PowerShell says the cmdlet isn't recognized | Connect first: Connect-ExchangeOnline, or open the Exchange Management Shell. |
| Add fails because the user already has an entry | Use Set-MailboxFolderPermission to change it. |
| The folder can't be found | Check the Mailbox:\Folder format and the folder's name in that mailbox. |
-SharingPermissionFlags is rejected |
It needs Exchange Online, a calendar folder and -AccessRights Editor. |
-SendNotificationToUser is rejected |
It needs Exchange Online, a calendar folder, and AvailabilityOnly, LimitedDetails, Reviewer or Editor. |
| A delegate stopped getting meeting requests after a Set | -SendNotificationToUser reset the flags. Run Set again with -SharingPermissionFlags Delegate. |
| A group was granted access but members can't see the folder | Use a mail-enabled security group. |
Summary
- Use
Mailbox:\Folderas the Identity. - Add creates an entry; Set replaces an existing one; Remove deletes it.
- Reviewer reads, Editor edits, Owner controls the folder. AvailabilityOnly and LimitedDetails are for calendars.
- In Exchange Online,
-SharingPermissionFlags Delegatewith Editor makes a calendar delegate. - Check the result with Get-MailboxFolderPermission.
Related: Remove-MailboxFolderPermission, Add-MailboxPermission, Get-MailboxPermission, resource mailbox delegates.
Meeting Room 365 turns any iPad or Android tablet into a room display for Exchange and Microsoft 365 calendars. See the features or pricing: $9 a display a month.