Skip to main content

​
SYNOPSIS

Sets calendar folder permissions for a mailbox in Exchange Online.

​
SYNTAX

Set-ExCalendarPermission [[-Identity] <String>] [[-AccessRights] <String>] [[-DelegateUser] <String>]

​
DESCRIPTION

Grants or updates calendar permissions for a delegate user on a target mailbox. The calendar folder is automatically resolved from the mailbox identity.

​
EXAMPLES

​
EXAMPLE 1

Set-ExCalendarPermission -Identity "john.doe@contoso.com" -AccessRights Reviewer -DelegateUser "jane.doe@contoso.com"
Grants read-only access to Jane on John’s calendar.

​
EXAMPLE 2

Set-ExCalendarPermission -Identity "john.doe@contoso.com" -AccessRights AvailabilityOnly -DelegateUser "jane.doe@contoso.com"
Grants free/busy visibility only to Jane on John’s calendar.

​
PARAMETERS

​
-Identity

The identity of the mailbox whose calendar permissions will be modified (email address, username, or display name). 
Type: String
Parameter Sets: (All)
Aliases:

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

​
-AccessRights

The permission level to grant to the delegate user. Accepted values:
  • None - The user has no permissions on the folder.
  • FreeBusyTimeOnly - The user can view only free/busy time within the calendar.
  • FreeBusyTimeAndSubjectAndLocation - The user can view free/busy time within the calendar and the subject and location of appointments.
  • Reviewer - The user can read all items in the folder.
  • Contributor - The user can create items in the folder. The contents of the folder do not appear.
  • NoneditingAuthor - The user can create and read all items in the folder, and delete only items that the user creates.
  • Author - The user can create and read all items in the folder, and edit and delete only items that the user creates.
  • PublishingAuthor - The user can create and read all items in the folder, edit and delete only items that the user creates, and create subfolders.
  • Editor - The user can create, read, edit and delete all items in the folder.
  • PublishingEditor - The user can create, read, edit, and delete all items in the folder, and create subfolders.
  • Owner - The user can create, read, edit, and delete all items in the folder, and create subfolders. The user is both folder owner and folder contact.
  • Custom - The user has custom access permissions on the folder.
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-DelegateUser

The user to whom the calendar permissions will be granted. 
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
INPUTS

​
OUTPUTS

​
NOTES

Requires the ExchangeOnlineManagement module and an active connection to Exchange Online.