New-QuarantinePermissions

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

Используйте командлет New-QuarantinePermissions, чтобы создать объекты разрешений на карантин для использования с командлетом New-QuarantineTag.

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

Синтаксис

New-QuarantinePermissions
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

Описание

Значение по умолчанию для всех параметров, которые вы не используете, — $false, поэтому вам нужно использовать только параметры (разрешения), для $true.

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

Примеры

Пример 1

$NoAccess = New-QuarantinePermissions

В этом примере создаются те же разрешения, которые используются группой "Нет разрешений на доступ" в тегах карантина в разделе Соответствие требованиям безопасности & . Объект permissions хранится в переменной с именем $NoAccess.

В том же Windows PowerShell сеансе можно использовать $NoAccess значение параметра EndUserQuarantinePermissions в команде New-QuarantineTag или Set-QuarantineTag.

Пример 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

В этом примере создаются те же разрешения, которые используются группой разрешений с ограниченным доступом в тегах карантина в разделе Соответствие требованиям безопасности & . Объект permissions хранится в переменной с именем $LimitedAccess.

В том же Windows PowerShell сеансе можно использовать $LimitedAccess значение параметра EndUserQuarantinePermissions в команде New-QuarantineTag или Set-QuarantineTag.

Пример 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

В этом примере создаются те же разрешения, которые используются группой разрешений для полного доступа в тегах карантина в разделе Соответствие требованиям безопасности & . Объект permissions хранится в переменной с именем $FullAccess.

В том же Windows PowerShell сеансе можно использовать $FullAccess значение параметра EndUserQuarantinePermissions в команде New-QuarantineTag или Set-QuarantineTag.

Параметры

-PermissionToBlockSender

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

  • $true: кнопка Блокировать отправителя включена в уведомления о карантине конечных пользователей.
  • $false: кнопка Блокировать отправителя не включена в уведомления о карантине конечных пользователей. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToDelete

Параметр PermissionToDelete указывает, разрешено ли пользователям удалять сообщения из карантина. Допустимые значения:

  • $true. Кнопка "Удалить из карантина" включена в сведения о сообщении, помещенном в карантин.
  • $false. Кнопка "Удалить из карантина" не включена в сведения о сообщении, помещенном в карантин. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToDownload

Параметр PermissionToDownload указывает, разрешено ли пользователям скачивать сообщения из карантина. Допустимые значения:

  • $true: разрешение включено.
  • $false: разрешение отключено. Это значение используется по умолчанию.

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

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

-PermissionToPreview

Параметр PermissionToPreview указывает, разрешено ли пользователям просматривать сообщения, помещенные в карантин. Допустимые значения:

  • $true. Кнопка предварительного просмотра сообщения включена в сведения о сообщении, помещенном в карантин.
  • $false. Кнопка предварительного просмотра сообщения не включена в сведения о сообщении, помещенном в карантин. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToRelease

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

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

Не устанавливайте для этого параметра и параметра PermissionToRequestRelease значение $true. Присвойте одному параметру значение $true, а другому — $false или задайте для обоих параметров значение $false.

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

-PermissionToRequestRelease

Параметр PermissionToRequestRelease указывает, разрешено ли пользователям запрашивать освобождение сообщений из карантина. Запрос должен быть утвержден администратором. Допустимые значения:

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

Не присвойте этому параметру и параметру PermissionRelease значение $true. Присвойте одному параметру значение $true, а другому — $false или задайте для обоих параметров значение $false.

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

-PermissionToViewHeader

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

  • $true: разрешение включено.
  • $false: разрешение отключено. Это значение используется по умолчанию.

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

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