Поделиться через


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

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

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

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

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

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

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

-Confirm

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

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

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

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

Тип:SwitchParameter
Default value: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
Default value: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 Security.

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

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

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

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

-Identity

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

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

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

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

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

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

-WhatIf

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

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

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

Тип:SwitchParameter
Default value: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.