Skip to main content

​
Set-ExCalendarPermission

​
SYNOPSIS

Sets calendar folder permissions for a mailbox in Exchange Online.

​
SYNTAX

​
Identity (Default)

​
AllMailboxes

​
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

Grants read-only access to Jane on John’s calendar.

​
EXAMPLE 2

Grants free/busy visibility only to Jane on John’s calendar.

​
EXAMPLE 3

Previews granting Reviewer access to the delegate on every mailbox calendar.

​
PARAMETERS

​
-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.

​
-AllMailboxes

Apply the calendar permission to all mailboxes in the organization.

​
-Confirm

Prompts you for confirmation before running the cmdlet.

​
-DelegateUser

The user to whom the calendar permissions will be granted.

​
-Identity

The identity of one or more mailboxes whose calendar permissions will be modified (email address, username, or display name).

​
-WhatIf

Runs the command in a mode that only reports what would happen without performing the actions.

​
CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

​
INPUTS

​
System.String[]

Not documented.

​
OUTPUTS

​
NOTES

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