Set-QuarantinePermissions

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

Используйте командлет Set-QuarantinePermissions для изменения объектов разрешений на карантин, которые используются в тегах карантина (командлеты New-QuarantineTag или Set-QuarantineTag). Этот командлет работает только с объектами разрешений, созданными командлетом New-QuarantinePermissions и сохраненными в переменной, доступной в настоящее время в сеансе Windows PowerShell.

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

Синтаксис

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

Описание

Чтобы просмотреть текущее значение объекта разрешений, который требуется изменить, выполните имя переменной в качестве команды. Например, выполните команду $Perms , чтобы просмотреть разрешения тега карантина, хранящиеся в переменной $Perms .

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

Примеры

Пример 1

Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false

В этом примере изменяются указанные разрешения тега карантина в объекте разрешений для выхода$Perms, созданном ранее в том же Windows PowerShell сеансе (переменная по-прежнему $Perms доступна и заполняется).

В том же Windows PowerShell сеансе можно использовать $Perms значение параметра 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

-QuarantinePermissionsObject

Параметр QuarantinePermissionsObject указывает переменную, содержащую объект разрешений на карантин, который требуется изменить. Например, если вы выполнили команду $Perms = New-QuarantinePermissions <permissions>, используйте значение $Perms для этого параметра.

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