Remove-CalendarEvents

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2019, Exchange Online

內部部署 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