Set-SafeLinksPolicy
Этот командлет доступен только в облачной службе.
Командлет Set-SafeLinksPolicy используется для изменения политик безопасных ссылок в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-SafeLinksPolicy
[-Identity] <SafeLinksPolicyIdParameter>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-ScanUrls <Boolean>]
[-TrackClicks <Boolean>]
[-UseTranslatedNotificationText <Boolean>]
[-WhatIf]
[<CommonParameters>] Описание
Безопасные ссылки — это функция в Microsoft Defender для Office 365, которая проверяет ссылки на наличие вредоносных веб-сайтов. Когда пользователь щелкает ссылку, URL-адрес временно переписывается и проверяется в списке известных вредоносных веб-сайтов. "Безопасные ссылки" включает функцию отчетов о трассировке URL-адреса, которая помогает определить пользователя, прошедшего по ссылке на вредоносный веб-сайт.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-SafeLinksPolicy -Identity "Engineering Block URL" -AllowClickThrough $falseВ этом примере изменяется существующая политика безопасных ссылок с именем URL-адрес инженерного блока, чтобы запретить переход по исходным URL-адресам на страницах предупреждений.
Параметры
-AdminDisplayName
Параметр AdminDisplayName указывает описание политики. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AllowClickThrough
Параметр AllowClickThrough указывает, следует ли разрешить пользователям переходить по исходному URL-адресу на страницах предупреждений. Допустимые значения:
$true: пользователю разрешено переходить по исходному URL-адресу. $false: пользователю не разрешено переходить по исходному URL-адресу.
В PowerShell значение по умолчанию — $false. В новых политиках безопасных ссылок, созданных на портале Microsoft 365 Defender, значение по умолчанию — $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 |
-CustomNotificationText
В пользовательском тексте уведомления указывается настраиваемый текст уведомления, который будет отображаться пользователям. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DeliverMessageAfterScan
Параметр DeliverMessageAfterScan указывает, следует ли доставлять сообщения электронной почты только после завершения проверки безопасных ссылок. Допустимые значения:
- $true. Дождитесь завершения проверки безопасных ссылок перед доставкой сообщения. Это значение используется по умолчанию. Сообщения, содержащие вредоносные ссылки, не доставляются.
- $false. Если проверка безопасных ссылок не удается завершить, добавьте сообщение в любом случае.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DisableUrlRewrite
Параметр DisableUrlRewrite указывает, следует ли перезаписывать (упаковывать) URL-адреса в сообщениях электронной почты. Допустимые значения:
- $true: URL-адреса в сообщениях не переписываются, но сообщения по-прежнему проверяются безопасными ссылками перед доставкой. Проверка времени нажатия ссылок выполняется с помощью API безопасных ссылок в поддерживаемых клиентах Outlook (в настоящее время Outlook для Windows и Outlook для Mac).
- $false: URL-адреса в сообщениях переписываются. Проверки API по-прежнему выполняются для незавернутых URL-адресов в поддерживаемых клиентах, если пользователь находится в допустимой политике безопасных ссылок.
В PowerShell значение по умолчанию — $false. В новых политиках безопасных ссылок, созданных на портале Microsoft 365 Defender, значение по умолчанию — $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DoNotRewriteUrls
Параметр DoNotRewriteUrls указывает URL-адреса, которые не переписываются при проверке безопасных ссылок. Список записей позволяет пользователям, включенным в политику, получать доступ к указанным URL-адресам, которые в противном случае были бы заблокированы безопасными ссылками.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Дополнительные сведения о синтаксисе записи см. в разделе Синтаксис записи для списка "Не переписывать следующие URL-адреса".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableForInternalSenders
Параметр EnableForInternalSenders указывает, применяется ли политика безопасных связей к сообщениям, отправляемых между внутренними отправителями и внутренними получателями в одной Exchange Online организации. Допустимые значения:
- $true: политика применяется к внутренним и внешним отправителям. Это значение используется по умолчанию.
- $false. Политика применяется только к внешним отправителям.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableOrganizationBranding
Параметр EnableOrganizationBranding указывает, отображается ли логотип вашей организации на страницах предупреждений и уведомлений о безопасных ссылках. Допустимые значения:
- $true: фирменная символика организации отображается на страницах предупреждений и уведомлений о безопасных ссылках. Перед настройкой этого значения необходимо выполнить инструкции, описанные в разделе Настройка темы Microsoft 365 для вашей организации для отправки логотипа компании.
- $false: фирменная символика организации не отображается на страницах предупреждений и уведомлений о безопасных ссылках. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableSafeLinksForEmail
Параметр EnableSafeLinksForEmail указывает, следует ли включить защиту безопасных ссылок для сообщений электронной почты. Допустимые значения:
- $true: для электронной почты включены безопасные ссылки. Это значение используется по умолчанию. Когда пользователь щелкает ссылку в сообщении электронной почты, ссылка будет проверяться с помощью безопасных ссылок. Если ссылка окажется вредоносной, в веб-браузере по умолчанию появится страница предупреждения.
- $false. Безопасные ссылки не включены для электронной почты.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableSafeLinksForOffice
Параметр EnableSafeLinksForOffice указывает, следует ли включить защиту безопасных ссылок для поддерживаемых классических, мобильных или веб-приложений Office. Допустимые значения:
- $true. Проверка безопасных ссылок включена в приложениях Office. Это значение используется по умолчанию. Когда пользователь открывает файл в поддерживаемом приложении Office и щелкает ссылку в файле, ссылка проверяется с помощью безопасных ссылок. Если ссылка окажется вредоносной, в веб-браузере по умолчанию появится страница предупреждения.
- $false. Безопасные ссылки не включены для приложений Office.
Обратите внимание, что эта защита применяется к ссылкам в документах Office, а не к ссылкам в сообщениях электронной почты.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableSafeLinksForTeams
Параметр EnableSafeLinksForTeams указывает, включены ли безопасные ссылки для Microsoft Teams. Допустимые значения:
- $true. Безопасные ссылки включены для Teams. Это значение используется по умолчанию. Когда пользователь щелкает ссылку в беседе Teams, групповом чате или из каналов, ссылка проверяется с помощью безопасных ссылок. Если ссылка окажется вредоносной, в веб-браузере по умолчанию появится страница предупреждения.
- $false. Безопасные ссылки для Teams не включены.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Параметр Identity определяет политику безопасных ссылок, которую требуется изменить. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | SafeLinksPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ScanUrls
Параметр ScanUrls указывает, следует ли включать или отключать сканирование в режиме реального времени для переходов по ссылкам в сообщениях электронной почты. Допустимые значения:
- $true: в режиме реального времени включено сканирование ссылок, в том числе ссылок, указывающих на файлы. Это значение используется по умолчанию.
- $false. Сканирование в режиме реального времени для ссылок, в том числе ссылок, указывающих на файлы, отключено.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TrackClicks
Параметр TrackClicks указывает, следует ли отслеживать переходы пользователей, связанные с защитой ссылок от безопасных ссылок. Допустимые значения:
- $true: щелчки пользователей отслеживаются. Это значение используется по умолчанию.
- $false: щелчки пользователей не отслеживаются.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UseTranslatedNotificationText
UseTranslatedNotificationText указывает, следует ли использовать Microsoft Translator для автоматической локализации пользовательского текста уведомления, указанного с помощью параметра CustomNotificationText. Допустимые значения:
- $true. Перевод пользовательского текста уведомления на язык пользователя.
- $false: не переводите текст пользовательского уведомления на язык пользователя. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе: https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по