Set-AtpPolicyForO365

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

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

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

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

Синтаксис

Default (По умолчанию)

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

Описание

Защита безопасных ссылок для приложений Office 365 проверяет ссылки в документах Office, а не в сообщениях электронной почты. Дополнительные сведения см. в статье Параметры безопасных ссылок для приложений Office 365.

Функция "Безопасные документы" сканирует документы и файлы, открытые в режиме защищенного просмотра. Дополнительные сведения см. в статье Безопасные документы в 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

Применимо: Exchange Online

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

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

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

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: Exchange Online

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EnableATPForSPOTeamsODB

Применимо: Exchange Online

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

  • $true. Безопасные вложения в SharePoint, OneDrive и Microsoft Teams включены. Администраторы SharePoint могут использовать параметр DisallowInfectedFileDownload в командлете Set-SPOTenant , чтобы управлять разрешениями пользователей на скачивание вредоносных файлов.
  • $false. Безопасные вложения в SharePoint, OneDrive и Microsoft Teams отключены. Это значение используется по умолчанию.

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EnableSafeDocs

Применимо: Exchange Online

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

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

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

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Online

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

Свойства параметров

Тип:AtpPolicyForO365IdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Применимо: Exchange Online

Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.