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 |