Remove-CalendarEvents
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Remove-CalendarEvents Cmdlet 取消使用者或資源信箱中未來的會議。 取消未來的會議會讓他們從出席者行事曆和資源行事曆中移除, (例如,您要移除信箱,或使用者要請假) 。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Remove-CalendarEvents
[-Identity] <MailboxIdParameter>
-QueryWindowInDays <Int32>
[-CancelOrganizedMeetings]
[-Confirm]
[-PreviewOnly]
[-QueryStartDate <ExDateTime>]
[-UseCustomRouting]
[-WhatIf]
[<CommonParameters>]
Description
此 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-30-2025 -QueryWindowInDays 120
此範例會取消 Angela Gruber 行事曆中指定日期範圍的會議。 Angela 要從公司暫時請假,因此取消這些會議會在她缺席期間從使用者和資源行事曆中移除。
範例 3
Remove-CalendarEvents -Identity "Jacob Berger" -CancelOrganizedMeetings -QueryStartDate 11-30-2025 -QueryWindowInDays 90 -PreviewOnly -Verbose
此範例預覽在指定日期範圍內,Jacob Berger 行事曆中將取消的會議。 信箱不會進行任何變更。
參數
-CancelOrganizedMeetings
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
CancelOrganizedMeetings 參數可指定是否要取消信箱中的會議。 您不需要使用此參數指定值。
若要取消信箱中的會議,您需要使用此切換。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 參數會指定要修改的信箱。 您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 網域\使用者名稱
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
參數屬性
| 類型: | MailboxIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PreviewOnly
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
PreviewOnly 參數可指定是否要預覽命令的結果,而不取消任何會議。 您不需要使用此參數指定值。
您可以將此參數與 [詳細資訊] 參數搭配使用。
注意:此 Cmdlet 的輸出一律顯示任何現有的會議已排入佇列等待取消。 但如果您使用此切換,則不會取消會議。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QueryStartDate
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
QueryStartDate 參數會指定開始日期,尋找您要取消的會議。
在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定為使用簡短的日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。
注意:如果您未使用此參數,則會使用今天的日期。
您可以使用 QueryWindowInDays 參數來指定結束日期。
參數屬性
| 類型: | ExDateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QueryWindowInDays
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
QueryWindowInDays 參數會指定在 QueryStartDate 參數值之後尋找您要取消的會議的天數。
如果週期性會議的實例在指定的時段內發生,則會取消整個系列,而不僅僅是) 時段內的實例 (。
附註: 會議取消允許的最長時間為 1825 天 (5 年) 。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseCustomRouting
適用:Exchange Online
此參數只能在雲端式服務中使用。
{{ 填滿 UseCustomRouting 描述 }}
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。