Set-AtpPolicyForO365

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Online

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

Используйте командлет Set-AtpPolicyForO365, чтобы изменить параметры для следующих функций в Microsoft Defender для Office 365:

  • Защита безопасных ссылок для поддерживаемых приложений Office 365.
  • Безопасные документы. Использует Microsoft Defender для конечной точки для сканирования документов и файлов, открытых в защищенном представлении в приложениях Microsoft 365 для предприятий.
  • Безопасные вложения для SharePoint, OneDrive и Microsoft Teams.

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

Синтаксис

Set-AtpPolicyForO365
   [[-Identity] <AtpPolicyForO365IdParameter>]
   [-AllowSafeDocsOpen <Boolean>]
   [-BlockUrls <MultiValuedProperty>]
   [-Confirm]
   [-EnableATPForSPOTeamsODB <Boolean>]
   [-EnableSafeDocs <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Защита безопасных ссылок для приложений Office 365 проверяет ссылки в документах Office, а не ссылки в сообщениях электронной почты. Дополнительные сведения см. в разделе [Параметры безопасных ссылок для приложений Office 365](https://learn.microsoft.com/microsoft-365/security/office-365-security/safe-links-about#safe-links-settings-for-office-365-apps.

Безопасные документы сканируют документы и файлы, открытые в защищенном представлении. Дополнительные сведения см. в разделе Безопасные документы в Microsoft 365 E5.

Безопасные вложения для SharePoint, OneDrive и Microsoft Teams не позволяют пользователям открывать и скачивать файлы, которые определены как вредоносные. Дополнительные сведения см. в статье Безопасные вложения для SharePoint, OneDrive и Microsoft Teams.

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

Примеры

Пример 1

Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true

В этом примере включается безопасные документы и безопасные вложения для SharePoint, OneDrive и Microsoft Teams.

Параметры

-AllowSafeDocsOpen

Параметр AllowSafeDocsOpen указывает, могут ли пользователи переходить по контейнеру Защищенное представление и обходить его, даже если безопасные документы идентифицируют файл как вредоносный. Допустимые значения:

  • $true. Пользователям разрешено выйти из контейнера Защищенное представление, даже если документ был идентифицирован как вредоносный.
  • $false. Пользователям запрещено выходить из защищенного представления в случае обнаружения вредоносных программ.

Этот параметр имеет смысл, только если значение параметра EnableSafeDocs $true.

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

-BlockUrls

Этот параметр устарел и больше не используется.

Функции этого параметра были заменены блок-записями для URL-адресов в списке разрешенных и заблокированных клиентов с помощью командлетов *-TenantAllowBlockListItems.

Type:MultiValuedProperty
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

-EnableATPForSPOTeamsODB

Параметр EnableATPForSPOTeamsODB включает или отключает безопасные вложения для SharePoint, OneDrive и Microsoft Teams. Допустимые значения:

  • $true: включены безопасные вложения для SharePoint, OneDrive и Microsoft Teams. Администраторы SharePoint Online могут использовать параметр DisallowInfectedFileDownload в командлете Set-SPOTenant , чтобы контролировать, разрешено ли пользователям загружать файлы, которые считаются вредоносными.
  • $false. Безопасные вложения для SharePoint, OneDrive и Microsoft Teams отключены. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeDocs

Параметр EnableSafeDocs включает или отключает безопасные документы в организациях с Microsoft 365 A5 или Безопасность Microsoft 365 E5 лицензиями. Допустимые значения:

  • $true. Функция "Безопасные документы" включена и будет отправлять пользовательские файлы в Microsoft Defender для конечной точки для проверки и проверки.
  • $false. Безопасные документы отключены. Это значение используется по умолчанию.

Дополнительные сведения о безопасных документах см. в разделе Безопасные документы в Microsoft 365 A5 или E5 Security.

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

-Identity

Параметр Identity указывает политику, которую требуется изменить. Существует только одна политика с именем "По умолчанию".

Type:AtpPolicyForO365IdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
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