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 |