Поделиться через


Set-QuarantinePolicy

Этот командлет доступен только в облачной службе.

Используйте командлет Set-QuarantinePolicy для изменения политик карантина в облачной организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-QuarantinePolicy
   [-Identity] <QuarantineTagIdParameter>
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-Confirm]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-IgnoreDehydratedFlag]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Вы не можете изменить встроенные политики карантина с именем AdminOnlyAccessPolicy или DefaultFullAccessPolicy.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1

В этом примере настраиваются разрешения в политике карантина с именем CustomAccess, которая позволяет пользователям удалять только сообщения, помещенные в карантин.

Пример 2

Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息,请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00

В этом примере изменяются глобальные параметры для уведомлений о карантине (ранее известные как параметры уведомлений о нежелательной почте для конечных пользователей):

  • Уведомления о карантине настраиваются для английского, китайского и французского языков. Дополнительные кавычки требуются во французском значении MultiLanguageCustomDisclaimer в качестве escape-символов для символов кавычки в тексте.
  • Существующий пользователь aashutosh@contso.onmicrosoft.com используется в качестве отправителя уведомления о карантине.
  • Ранее настроенный пользовательский логотип заменяет логотип Майкрософт по умолчанию.
  • Частота уведомлений о карантине изменяется до 4 часов.

Параметры

-AdminNotificationFrequencyInDays

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminNotificationLanguage

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminQuarantinePermissionsList

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection

-CustomDisclaimer

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DomainController

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissions

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:QuarantinePermissions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissionsValue

Параметр EndUserQuarantinePermissionsValue указывает разрешения конечного пользователя для политики карантина.

Этот параметр использует десятичное значение, преобразованное из двоичного значения. Двоичное значение соответствует списку доступных разрешений в определенном порядке. Для каждого разрешения значение 1 равно True, а значение 0 — false. Требуемый порядок описан в следующем списке с самого высокого (10000000 или 128) до самого низкого (00000001 или 1):

  • PermissionToViewHeader: значение 0 не скрывает действие Просмотр заголовка сообщения в карантине. Если сообщение отображается в карантине, действие всегда доступно для сообщения.
  • PermissionToDownload: это разрешение не используется (значение 0 или 1 ничего не делает).
  • PermissionToAllowSender: это разрешение не используется (значение 0 или 1 ничего не делает).
  • PermissionToBlockSender
  • PermissionToRequestRelease: не устанавливайте для этого разрешения и PermissionToRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или задайте для обоих значений значение 0.
  • PermissionToRelease: не устанавливайте для этого разрешения и PermissionToRequestRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или задайте для обоих значений значение 0. Это разрешение не предоставляется для сообщений, которые были помещены в карантин как вредоносные программы или фишинг с высокой степенью достоверности. Если политика карантина предоставляет пользователям это разрешение, пользователи могут запрашивать выпуск их помещенных в карантин вредоносных программ или фишинговых сообщений с высокой степенью достоверности, как если бы вместо этого было выбрано PermissionToRequestRelease.
  • PermissionToPreview
  • PermissionToDelete

Значения для предустановленных групп разрешений конечных пользователей описаны в следующем списке:

  • Нет доступа: Binary = 0000000, поэтому используйте десятичное значение 0.
  • Ограниченный доступ: Binary = 00011011, поэтому используйте десятичное значение 27.
  • Полный доступ: Binary = 00010111, поэтому используйте десятичное значение 23.

Для пользовательских разрешений получите двоичное значение, соответствующее нужным разрешениям. Преобразуйте двоичное значение в десятичное значение для использования. Не используйте двоичное значение для этого параметра.

Примечание. Если значение этого параметра равно 0 (нет доступа), а значение параметра ESNEnabled равно $true, пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationCustomFromAddress

EndUserSpamNotificationCustomFromAddress указывает адрес электронной почты существующего внутреннего отправителя, который будет использоваться в качестве отправителя для уведомлений о карантине. Чтобы задать для этого параметра адрес quarantine@messaging.microsoft.comэлектронной почты по умолчанию, используйте значение $null.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequency

Параметр EndUserSpamNotificationFrequency определяет частоту отправки уведомлений о карантине пользователям. Допустимые значения:

  • 04:00:00 (4 часа)
  • 1.00:00:00 (1 день)
  • 7.00:00:00 (7 дней)
Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationLanguage

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EsnCustomSubject

Параметр EsnCustomSubject указывает текст, используемый в поле Тема уведомлений о карантине.

Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.

Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.

Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:undefined
Aliases:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ESNEnabled

Параметр ESNEnabled указывает, следует ли включать уведомления о карантине (прежнее название — уведомления о нежелательной почте конечных пользователей) для политики. Допустимые значения:

  • $true. Уведомления о карантине включены.
  • $false. Уведомления о карантине отключены. Пользователь может получить доступ к сообщениям, помещенным в карантин, только в карантине, а не в Уведомления по электронной почте. Это значение используется по умолчанию.

Примечание. Если значение этого параметра равно $true, а значение параметра EndUserQuarantinePermissionsValue равно 0 (нет доступа, где отключены все разрешения), пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Параметр Identity указывает политику карантина, которую требуется изменить. Можно использовать любое значение, однозначно определяющее политику карантина. Например:

  • имя;
  • различающееся имя (DN);
  • GUID
Type:QuarantineTagIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageCustomDisclaimer

Параметр MultiLanguageCustomDisclaimer указывает пользовательский текст заявления об отказе, который будет использоваться в нижней части уведомлений о карантине. Локализованный текст , Отказ от ответственности от вашей организации: всегда включается первым, а затем текст, указанный для этого параметра.

Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст пользовательского заявления об отказе. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.

Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.

Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageSenderName

Параметр MultiLanguageSenderName указывает отображаемое имя отправителя электронной почты для использования в уведомлениях о карантине.

Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, можно указать уникальное имя отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer и MultiLanguageSenderName в том же порядке.

Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.

Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageSetting

Параметр MultiLanguageSetting указывает язык уведомлений о карантине. Допустимые значения:

Default, амхарский, арабский, баскский, бенгальский индейский, болгарский, каталанский, китайскийSimplified, китайскийтрадиционный, хорватский, кириллица, Чешский, датский, голландский, английский, филиппинский, финский, французский, галисийский, немецкий, греческий, Гуджарати, иврит, хинди, венгерский, исландский, индонезийский, итальянский, каннада, корейский, корейский, латышский, латышский, малайский, малайялам, маратхи, норвежский, норвежский, nynornorsk, Odia, персидский, польский, португальский, португальскийPortugal, румынский, русский, сербский, сербский кириллица, Словацкий, словенский, испанский, суахили, шведский, тамильский, телугу, тайский, турецкий, украинский, урду и вьетнамский.

Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Значение по умолчанию — Default, что означает, что уведомления о карантине используют язык по умолчанию облачной организации.

Для каждого указанного языка можно указать уникальное значение для параметров MultiLanguageCustomDisclaimer и MultiLanguageSenderName. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer и MultiLanguageSenderName в том же порядке.

Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

Параметр OrganizationBrandingEnabled включает или отключает фирменную символику организации в уведомлениях о карантине конечных пользователей. Допустимые значения:

  • $true: включена фирменная символика организации. Логотип Майкрософт по умолчанию, используемый в уведомлениях о карантине, заменяется пользовательским логотипом. Перед этим необходимо выполнить инструкции, описанные в разделе Настройка темы Microsoft 365 для вашей организации для отправки пользовательского логотипа.
  • $false: фирменная символика организации отключена. Логотип Майкрософт по умолчанию используется в уведомлениях о карантине. Это значение используется по умолчанию.

Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-QuarantineRetentionDays

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection