Set-AtpPolicyForO365

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Online

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:

  • Protección de vínculos seguros para aplicaciones de Office 365 compatibles.
  • Documentos seguros: usa Microsoft Defender para punto de conexión para examinar documentos y archivos abiertos en la vista protegida en aplicaciones de Microsoft 365 para empresas.
  • Datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams.

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>]
   [-AllowSafeDocsOpen <Boolean>]
   [-BlockUrls <MultiValuedProperty>]
   [-Confirm]
   [-EnableATPForSPOTeamsODB <Boolean>]
   [-EnableSafeDocs <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Protección de vínculos seguros para aplicaciones de Office 365 comprueba vínculos en documentos de Office, no vínculos en mensajes de correo electrónico. Para obtener más información, vea [Configuración de vínculos seguros para aplicaciones de Office 365](https://learn.microsoft.com/microsoft-365/security/office-365-security/safe-links-about#safe-links-settings-for-office-365-apps.

Documentos seguros examina los documentos y archivos que se abren en la vista protegida. Para obtener más información, consulte Documentos seguros en Microsoft 365 E5.

Los datos adjuntos seguros para 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 Datos adjuntos seguros para 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 -EnableATPForSPOTeamsODB $true

En este ejemplo se habilitan los documentos seguros y los datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams.

Parámetros

-AllowSafeDocsOpen

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

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

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

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

-BlockUrls

Este parámetro ya no se usa y quedará obsoleto.

La funcionalidad de este parámetro se ha reemplazado por entradas de bloque para direcciones URL en la lista de permitidos o bloques de inquilinos mediante los cmdlets *-TenantAllowBlockListItems.

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

-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, 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 demás cmdlets (por ejemplo, los cmdlets 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableATPForSPOTeamsODB

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

  • $true: Los datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams están habilitados. Los administradores de SharePoint Online pueden usar el parámetro DisallowInfectedFileDownload en el cmdlet Set-SPOTenant para controlar si los usuarios pueden descargar archivos que se encuentran como malintencionados.
  • $false: Los datos adjuntos seguros para SharePoint, OneDrive y Microsoft Teams están deshabilitados. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeDocs

El parámetro EnableSafeDocs habilita o deshabilita documentos seguros en organizaciones con licencias de Microsoft 365 A5 o Seguridad de Microsoft 365 E5. Los valores admitidos son:

  • $true: Documentos seguros está habilitado y cargará archivos de usuario en Microsoft Defender para punto de conexión para su examen y verificación.
  • $false: Documentos seguros está deshabilitado. Este es el valor predeterminado.

Para obtener más información sobre los documentos seguros, consulte Documentos seguros en Microsoft 365 A5 o seguridad E5.

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

-Identity

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

Type:AtpPolicyForO365IdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online