Remove-CalendarEvents

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 Remove-CalendarEvents cmdlet 取消用户或资源邮箱中未来的会议。 取消以后的会议会将其从与会者和资源日历中删除, (例如,你要删除邮箱,或者用户正在休假) 。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Remove-CalendarEvents
      [-Identity] <MailboxIdParameter>
      -QueryWindowInDays <Int32>
      [-CancelOrganizedMeetings]
      [-Confirm]
      [-PreviewOnly]
      [-QueryStartDate <ExDateTime>]
      [-WhatIf]
      [<CommonParameters>]

说明

此 cmdlet 取消指定邮箱中的会议,其中邮箱是会议组织者,并且会议包含一个或多个与会者或资源。 它不会取消没有与会者或资源的约会或会议。 由于必须发送会议取消,因此仍必须启用邮箱以发送邮件。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Remove-CalendarEvents -Identity chris@contoso.com -CancelOrganizedMeetings -QueryWindowInDays 120

本示例取消邮箱 chris@contoso.com 中在当天日期或 120 天后召开的每一次会议。 取消会议后,可以删除邮箱。

示例 2

Remove-CalendarEvents -Identity "Angela Gruber" -CancelOrganizedMeetings -QueryStartDate 11-1-2018 -QueryWindowInDays 120

本示例取消安吉拉·格鲁伯日历中指定日期范围的会议。 Angela 正在公司暂时请假,因此取消这些会议将在她缺席期间将其从用户和资源日历中删除。

示例 3

Remove-CalendarEvents -Identity "Jacob Berger" -CancelOrganizedMeetings -QueryStartDate 9-1-2018 -QueryWindowInDays 90 -PreviewOnly -Verbose

本示例预览将在雅各布·伯杰日历中针对指定日期范围取消的会议。 不会对邮箱进行更改。

参数

-CancelOrganizedMeetings

CancelOrganizedMeetings 开关指定是否取消邮箱中的会议。 不必为此开关指定值。

若要取消邮箱中的会议,需要使用此开关。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online

-Identity

Identity 参数指定要修改的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online

-PreviewOnly

PreviewOnly 开关指定是否在不实际取消任何会议的情况下预览命令的结果。 不必为此开关指定值。

将此开关与“详细”开关一起使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online

-QueryStartDate

QueryStartDate 参数指定要查找要取消的会议的开始日期。

请使用短日期格式,该格式在运行命令的计算机上的“区域选项”设置中定义。 例如,如果将计算机配置为使用短日期格式 mm/dd/yyyy,请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期,也可以输入当天的日期和时间。 如果输入当天的日期和时间,请将该值括在引号 (") 中,例如,"09/01/2018 5:00 PM"。

注意:如果不使用此参数,则使用今天的日期。

使用 QueryWindowInDays 参数指定结束日期。

Type:ExDateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online

-QueryWindowInDays

QueryWindowInDays 参数指定 QueryStartDate 参数值之后的天数,以查找要取消的会议。

如果定期会议的实例在指定的时间段内发生,则整个系列将取消 (而不仅仅是) 时间段的实例。

注意:允许取消会议的最大时段为 1825 天 (5 年) 。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online