Set-MailboxAutoReplyConfiguration
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Set-MailboxAutoReplyConfiguration Cmdlet 來設定特定信箱的自動回復設定。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Set-MailboxAutoReplyConfiguration
[-Identity] <MailboxIdParameter>
[-AutoDeclineFutureRequestsWhenOOF <Boolean>]
[-AutoReplyState <OofState>]
[-Confirm]
[-CreateOOFEvent <Boolean>]
[-DeclineAllEventsForScheduledOOF <Boolean>]
[-DeclineEventsForScheduledOOF <Boolean>]
[-DeclineMeetingMessage <String>]
[-DomainController <Fqdn>]
[-EndTime <DateTime>]
[-EventsToDeleteIDs <String[]>]
[-ExternalAudience <ExternalAudience>]
[-ExternalMessage <String>]
[-IgnoreDefaultScope]
[-InternalMessage <String>]
[-OOFEventSubject <String>]
[-StartTime <DateTime>]
[-WhatIf]
[<CommonParameters>]
Description
您可以停用指定信箱或組織的自動回復。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-MailboxAutoReplyConfiguration -Identity tony@contoso.com -AutoReplyState Scheduled -StartTime "7/10/2018 08:00:00" -EndTime "7/15/2018 17:00:00" -InternalMessage "Internal auto-reply message"
此範例會設定要在指定的開始和結束日期之間傳送的自動回復,並包含內部回復。
範例 2
Set-MailboxAutoReplyConfiguration -Identity tony@contoso.com -AutoReplyState Enabled -InternalMessage "Internal auto-reply message." -ExternalMessage "External auto-reply message." -ExternalAudience All
此範例會設定要傳送的自動回復,指定來自內部和外部寄件者的郵件回復,並指定外部回復傳送至任何外部地址。
參數
-AutoDeclineFutureRequestsWhenOOF
此參數只能在雲端式服務中運作。
AutoDeclineFutureRequestsWhenOOF 參數會指定是否要在自動回復傳送時,于排程的期間內自動拒絕傳送至信箱的新會議邀請。 有效值為:
- $true:在排定的期間內收到的新會議邀請會自動遭到拒絕。
- $false:在排程的時間週期內收到的會議邀請不會自動遭到拒絕。 這是預設值。
只有在 AutoReplyState 參數設定為 Scheduled 時,才能使用此參數。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AutoReplyState
AutoReplyState 參數會指定是否啟用自動回復的信箱。 有效值為:
- 已啟用:會針對信箱傳送自動回復。
- 已停用:不會傳送信箱的自動回復。 這是預設值。
- 已排程:自動回復會在 StartTime 和 EndTime 參數所指定的期間內,針對信箱傳送。
Enabled 和 Scheduled 值需要下列額外設定:
- InternalMessageValue 參數的值。
- 如果 ExternalAudience 參數設定為 Known 或 All,則為 ExternalMessageValue 參數的值。
Type: | OofState |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CreateOOFEvent
此參數只能在雲端式服務中運作。
CreateOOFEvent 參數會指定是否要建立行事曆事件,此事件會對應至針對信箱傳送自動回復時的排程時間週期。 有效值為:
- $true:當您使用 AutoReplyState 參數的 Scheduled 值來設定自動回復的排程時段時,會在信箱中建立這些日期的行事曆事件。 您可以使用 OOFEventSubject 參數來指定事件的主旨。
- $false:當您使用 AutoReplyState 參數的 Scheduled 值來設定自動回復的排程時段時,不會針對這些日期建立任何行事曆事件。 這是預設值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DeclineAllEventsForScheduledOOF
此參數只能在雲端式服務中運作。
DeclineAllEventsForScheduledOOF 參數會指定是否要在傳送自動回復的排程期間內,拒絕信箱中所有現有的行事曆事件。 有效值為:
- $true:在排定的時段內發生的信箱中現有的行事曆事件會遭到拒絕,並從行事曆中移除。 如果信箱是會議召集人,則會取消所有其他出席者的活動。
- $false:在已排程的時間週期期間,信箱中發生的現有行事曆事件會保留在行事曆中。 這是預設值。
只有在將 DeclineEventsForScheduledOOF 參數設定為 $true 時,才能使用此參數。
您無法搭配 EventsToDeleteIDs 參數使用此參數。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DeclineEventsForScheduledOOF
此參數只能在雲端式服務中運作。
DeclineEventsForScheduledOOF 參數會指定是否可以在傳送自動回復的排程期間內,拒絕信箱中現有的行事曆事件。 有效值為:
$true:在已排程的時間週期內發生的信箱中現有的行事曆事件可以遭到拒絕,並從行事曆中移除。 如果信箱是會議召集人,則會取消所有其他出席者的活動。
若要在排程的時間週期內拒絕特定事件,請使用 EventsToDeleteIDs 參數。 若要在排程的時間週期內拒絕所有事件,請使用 DeclineAllEventsForScheduledOOF 參數。
$false:在已排程的時間週期期間,信箱中發生的現有行事曆事件會保留在行事曆中。 這是預設值。
只有在 AutoReplyState 參數設定為 Scheduled 時,才能使用此參數。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DeclineMeetingMessage
此參數只能在雲端式服務中運作。
當傳送至信箱的會議要求自動遭到拒絕時,DeclineMeetingMessage 參數會指定訊息中的文字。 例如:
- AutoDeclineFutureRequestsWhenOOF 參數設定為 $true。
- DeclineEventsForScheduledOOF 參數設定為 $true,而 DeclineAllEventsForScheduledOOF 參數設定為 $true,或是使用 EventsToDeleteIDs 參數指定個別事件。
如果值包含空格,請使用引號 (") 括住值。 HTML 標籤不會自動新增至文字,但您可以使用包含 HTML 標籤的值。 例如,"<html><body>I'm on vacation. <b>I can't attend the meeting.</b></body></html>"
。
若要清除此參數的值,請使用值$null。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EndTime
EndTime 參數會指定為信箱傳送自動回復的結束日期和時間。 只有在 AutoReplyState 參數設定為 Scheduled 時,才使用此參數,而且只有當 AutoReplyState 是 Scheduled 時,此參數的值才有意義。
在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 mm/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EventsToDeleteIDs
此參數只能在雲端式服務中運作。
當 DeclineEventsForScheduledOOF 參數設定為 $true 時,EventsToDeleteIDs 參數會指定要從信箱中刪除的行事曆事件。
您可以指定多個以逗號分隔的行事曆事件。
您無法將此參數與 DeclineAllEventsForScheduledOOF 參數搭配使用。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExternalAudience
ExternalAudience 參數會指定自動回復是否傳送給外部寄件者。 有效值為:
- 無:自動回復不會傳送給任何外部寄件者。
- 已知:自動回復只會傳送給信箱 [連絡人] 清單中指定的外部寄件者。
- 全部:自動回復會傳送給所有外部寄件者。 這是預設值。
只有當 AutoReplyState 參數設定為 Enabled 或 Scheduled 時,這個參數的值才有意義。
Type: | ExternalAudience |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExternalMessage
ExternalMessage 參數會指定傳送給外部寄件者或組織外部寄件者的自動回復訊息。 如果值包含空格,請使用引號 (") 括住值。
自動在文字中加入 HTML 標記。 例如,如果您輸入文字「我正在休假」,則值會自動變成: <html><body>I'm on vacation</body></html>
。 如果您以引號括住值,則支援其他 HTML 標籤。 例如,"<html><body><b>I'm on vacation</b>. I'll respond when I return.</body></html>"
。
只有當下列兩個條件都成立時,此參數的值才有意義:
- AutoReplyState 參數設定為 Enabled 或 Scheduled。
- ExternalAudience 參數設定為 Known 或 All。
例如,若要在不再需要此參數時清除此參數的值 (,如果您將 ExternalAudience 參數變更為 None) ,請使用值$null。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
IgnoreDefaultScope 參數會指示命令忽略 Exchange PowerShell 會話的預設收件者範圍設定,並使用整個樹系作為範圍。 您不需要使用此參數指定值。
此參數可讓 命令存取預設範圍中目前無法使用的 Active Directory 物件,但也引進下列限制:
- 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
- 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-InternalMessage
InternalMessage 參數會指定傳送給組織內部寄件者或寄件者的自動回復訊息。 如果值包含空格,請使用引號 (") 括住值。
自動在文字中加入 HTML 標記。 例如,如果您輸入下列文字:「我正在休假」,則值會自動變成: <html><body>I'm on vacation</body></html>
。 如果您以引號括住值,則支援其他 HTML 標籤。 例如,"<html><body>I'm on vacation. <b>Please contact my manager.</b></body></html>"
。
只有當 AutoReplyState 參數設定為 Enabled 或 Scheduled 時,這個參數的值才有意義。
例如,若要在不再需要此參數時清除此參數的值 (,如果您將 AutoReplyState 參數變更為 Disabled) ,請使用 $null 值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-OOFEventSubject
此參數只能在雲端式服務中運作。
OOFEventSubject 參數會指定當 CreateOOFEvent 參數設定為 $true 時自動建立之行事曆事件的主旨。
如果值包含空格,請使用引號 (") 括住值。 若要清除此參數的值,請使用值$null。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-StartTime
StartTime 參數會指定為指定信箱傳送自動回復的開始日期和時間。 只有在 AutoReplyState 參數設定為 Scheduled 時,才使用此參數,而且只有當 AutoReplyState 是 Scheduled 時,此參數的值才有意義。
在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 mm/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。