Set-MailboxAutoReplyConfiguration
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Set-MailboxAutoReplyConfiguration для настройки параметров автоматических ответов в определенном почтовом ящике.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
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>] Описание
Автоматические ответы можно отключить для определенного почтового ящика или организации.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье 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.
- Значение для параметра ExternalMessageValue, если параметр ExternalAudience имеет значение Известный или Все.
| 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
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя 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. При настройке запланированного периода времени для автоматических ответов с помощью значения Scheduled для параметра AutoReplyState в почтовом ящике создается событие календаря для этих дат. Вы можете указать тему события, используя параметр OOFEventSubject.
- $false. При настройке запланированного периода времени для автоматических ответов с помощью значения Scheduled для параметра AutoReplyState событие календаря не создается для этих дат. Это значение используется по умолчанию.
| 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 указывает контроллер домена, который используется этим командлетом для чтения или записи данных в 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).
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 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
Этот параметр работает только в облачной службе.
Параметр EventsToDeleteIDs указывает события календаря, которые необходимо удалить из почтового ящика, когда для параметра DeclineEventsForScheduledOOF задано значение $true.
Вы можете указать несколько событий календаря через запятую.
Этот параметр нельзя использовать вместе с параметром 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);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
| 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).
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.