Set-AtpPolicyForO365

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-AtpPolicyForO365 para modificar la configuración de las siguientes características en Microsoft Defender para Office 365:

  • Caja fuerte Vincula la protección para aplicaciones Office 365 compatibles.
  • Caja fuerte Documentos: usa Microsoft Defender para endpoint para examinar documentos y archivos que se abren en la vista protegida en Microsoft 365 aplicaciones para empresas.
  • Caja fuerte Datos adjuntos SharePoint, OneDrive y Microsoft Teams.

Nota: Se recomienda que use el módulo de Exchange Online PowerShell V2 para conectarse a Exchange Online PowerShell. Para obtener instrucciones, consulte Conexión a Exchange Online PowerShell.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Caja fuerte La protección de vínculos Office 365 aplicaciones comprueba vínculos en Office documentos, no vínculos en mensajes de correo electrónico. Para obtener más información, consulta Caja fuerte configuración de vínculos para Office 365 aplicaciones.

Caja fuerte Los documentos examinan documentos y archivos que se abren en la vista protegida. Para obtener más información, vea Caja fuerte Documents en Microsoft 365 E5.

Caja fuerte Los datos adjuntos SharePoint, OneDrive y Microsoft Teams impiden que los usuarios abran y descarguen archivos que se identifican como malintencionados. Para obtener más información, vea Caja fuerte attachments for SharePoint, OneDrive y Microsoft Teams.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Set-AtpPolicyForO365 -EnableSafeLinksForClients $true -EnableATPForSPOTeamsODB $true

En este ejemplo se Caja fuerte documentos y Caja fuerte datos adjuntos para SharePoint, OneDrive y Microsoft Teams.

Parámetros

-AllowClickThrough

El parámetro AllowClickThrough especifica si se permite a los usuarios hacer clic en la dirección URL bloqueada original en la protección de vínculos de Caja fuerte para Office aplicaciones. Los valores admitidos son:

  • $true: los usuarios pueden hacer clic en la dirección URL original en las aplicaciones Office compatibles.
  • $false: los usuarios no pueden hacer clic en la dirección URL original en las aplicaciones Office compatibles. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-AllowSafeDocsOpen

El parámetro AllowSafeDocsOpen especifica si los usuarios pueden hacer clic y omitir el contenedor vista protegida incluso cuando Caja fuerte Documents identifica un archivo como malintencionado. Los valores admitidos son:

  • $true: los usuarios pueden salir del contenedor vista protegida incluso si el documento se ha identificado como malintencionado.
  • $false: los usuarios no pueden salir de la vista protegida en caso de detección malintencionada.

Este parámetro es significativo solo cuando el valor del parámetro EnableSafeDocs es $true.

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

El parámetro BlockUrls especifica las direcciones URL que siempre están bloqueadas por Caja fuerte vínculos en mensajes de correo electrónico y vínculos Caja fuerte para Office 365 aplicaciones.

Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Para obtener más información acerca de la sintaxis de entrada, vea Entry syntax for the "Block the following URLs" list.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-EnableATPForSPOTeamsODB

El parámetro EnableATPForSPOTeamsODB habilita o deshabilita Caja fuerte datos adjuntos para SharePoint, OneDrive y Microsoft Teams. Los valores admitidos son:

  • $true: Caja fuerte datos adjuntos para SharePoint, OneDrive y Microsoft Teams está habilitado. SharePoint Los administradores en línea pueden usar el parámetro DisallowInfectedFileDownload en el cmdlet Set-SPOTenant para controlar si los usuarios pueden descargar archivos que se encuentran malintencionados.
  • $false: Caja fuerte datos adjuntos para SharePoint, OneDrive y Microsoft Teams está deshabilitado. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-EnableSafeDocs

El parámetro EnableSafeDocs habilita o deshabilita Caja fuerte documentos en Microsoft 365 E5 o Seguridad de Microsoft 365 E5 organizaciones. Los valores admitidos son:

  • $true: Caja fuerte documents está habilitado y cargará archivos de usuario en Microsoft Defender para endpoint para su análisis y comprobación.
  • $false: Caja fuerte documents está deshabilitado. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-EnableSafeLinksForO365Clients

El parámetro EnableSafeLinksForO365Clients habilita o deshabilita Caja fuerte vínculos para Office 365 aplicaciones. Los valores admitidos son:

  • $true: el Caja fuerte de vínculos está habilitado en aplicaciones Office 365 compatibles. Este es el valor predeterminado.
  • $false: el Caja fuerte de vínculos está deshabilitado en aplicaciones Office 365 compatibles.

Tenga en cuenta que esta protección se aplica a los vínculos de Office documentos, no a los vínculos de los mensajes de correo electrónico. Caja fuerte La protección de vínculos para vínculos en mensajes de correo electrónico está controlada por Caja fuerte links (los cmdlets New-SafeLinksPolicy o Set-SafeLinksPolicy).

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-EnableSafeLinksForWebAccessCompanion

Este parámetro está reservado para uso interno de Microsoft.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Identidad

El parámetro Identity especifica la directiva que desea modificar. Solo hay una directiva denominada Default.

Type:AtpPolicyForO365IdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-TrackClicks

El parámetro TrackClicks especifica si se debe realizar un seguimiento de los clics del usuario relacionados con las direcciones URL bloqueadas en Caja fuerte vínculos para Office 365 aplicaciones. Los valores admitidos son:

  • $true: se realiza un seguimiento de los clics del usuario Office 365 aplicaciones compatibles.
  • $false: no se realiza un seguimiento de los clics del usuario Office 365 aplicaciones admitidas. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Entradas

Salidas