Set-TenantAllowBlockListItems
Этот командлет доступен только в облачной службе.
Используйте командлет Set-TenantAllowBlockListItems для изменения записей в списке разрешенных и заблокированных клиентов на портале Microsoft 365 Defender.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-TenantAllowBlockListItems
-Ids <String[]>
-ListType <ListType>
[-Allow]
[-Block]
[-ExpirationDate <DateTime>]
[-ListSubType <ListSubType>]
[-NoExpiration]
[-Notes <String>]
[-OutputJson]
[<CommonParameters>] Set-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-Allow]
[-Block]
[-ExpirationDate <DateTime>]
[-ListSubType <ListSubType>]
[-NoExpiration]
[-Notes <String>]
[-OutputJson]
[<CommonParameters>] Описание
В большинстве случаев невозможно изменить значения URL-адреса, файла или отправителя существующей записи. Единственным исключением являются разрешенные записи URL-адресов для имитации фишинга (Action = Allow, ListType = URL и ListSubType = AdvancedDelivery). Дополнительные сведения о том, как разрешить URL-адреса для имитации фишинга, см. в разделе Настройка доставки сторонних симуляций фишинга пользователям и нефильтрованных сообщений в почтовые ящики SecOps.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()В этом примере изменяется дата окончания срока действия указанной записи.
Пример 2
Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021В этом примере изменяется дата окончания срока действия url-адреса, разрешающего запись для указанного стороннего URL-адреса имитации фишинга.
Параметры
-Allow
Параметр Разрешить указывает, что вы изменяете запись разрешения. Указывать значение для этого параметра необязательно.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Block
Параметр Блокировать указывает, что вы изменяете запись блока. Для этого переключателя не требуется указывать значение.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Entries
Параметр Entries указывает записи, которые необходимо изменить на основе значения параметра ListType. Допустимые значения:
- FileHash: точное хэш-значение файла SHA256.
- Домены отправителя и адреса электронной почты: точное значение домена или адреса электронной почты.
- URL-адрес: точное значение URL-адреса.
Это значение отображается в свойстве Value записи в выходных данных командлета Get-TenantAllowBlockListItems.
Нельзя смешивать типы значений (файл, отправитель или URL-адрес) или разрешать и блокировать действия в одной команде.
Этот параметр нельзя использовать с параметром Ids.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ExpirationDate
Параметр ExpirationDate фильтрует результаты по дате окончания срока действия в формате UTC.
Чтобы указать значение даты или времени для этого параметра, воспользуйтесь одним из следующих вариантов:
- Укажите значение даты и времени в формате UTC: например,
"2021-05-06 14:30:00z". - Укажите значение даты и времени в качестве формулы, которая преобразует дату и время в местном часовом поясе в utc: например.
(Get-Date "5/6/2020 9:30 AM").ToUniversalTime()Для получения дополнительной информации см. Get-Date.
Этот параметр нельзя использовать с параметром NoExpiration.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Ids
Параметр Ids указывает записи, которые требуется изменить. Это значение отображается в свойстве Identity в выходных данных командлета Get-TenantAllowBlockListItems.
Примером значения для этого параметра является RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.
Этот параметр нельзя использовать с параметром Entries.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ListSubType
Параметр ListSubType дополнительно указывает запись, которую требуется изменить. Допустимые значения:
- AdvancedDelivery: используйте это значение для URL-адресов имитации фишинга. Дополнительные сведения см. в статье Настройка предоставления сторонней эмуляции фишинговых атак пользователям и доставки нефильтруемых сообщений в почтовые ящики SecOps.
- Клиент. Это значение по умолчанию.
| Type: | ListSubType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ListType
Параметр ListType указывает тип записи, которую требуется изменить. Допустимые значения:
- FileHash
- Sender
- Url
Используйте параметр Entries или Ids с этим параметром, чтобы идентифицировать саму запись.
| Type: | ListType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-NoExpiration
Параметр NoExpiration указывает, что срок действия записи не должен истекать. Для этого переключателя не требуется указывать значение.
Этот параметр доступен для использования с блоками или с url-адресами allow, где значение параметра ListSubType — AdvancedDelivery.
Этот параметр нельзя использовать с параметром ExpirationDate.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Notes
Параметр Notes указывает дополнительные сведения об объекте. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-OutputJson
Параметр OutputJson указывает, следует ли возвращать все записи в одном значении JSON. Указывать значение для этого параметра необязательно.
Этот параметр используется для предотвращения остановки команды в первой записи, содержащей синтаксическую ошибку.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по