共用方式為


Remove-CalendarEvents

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Remove-CalendarEvents Cmdlet 來取消使用者或資源信箱中未來的會議。 取消未來的會議會將他們從出席者和資源行事曆移除 (例如,您要移除信箱,或使用者即將離開) 。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

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

Description

此 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

本範例會取消指定日期範圍之在 Gruber 行事曆中的會議。 如果要暫時離開公司,則取消這些會議會在使用者和資源行事曆中移除這些會議。

範例 3

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

此範例會預覽在指定日期範圍的 Berger 行事曆中取消的會議。 信箱不會進行任何變更。

參數

-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)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (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 參數會指定是否要預覽命令的結果,而不實際取消任何會議。 您不需要使用此參數指定值。

您可以使用此參數搭配 Verbose 參數。

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