Set-SafeLinksPolicy

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

Use el cmdlet Set-SafeLinksPolicy para modificar directivas de vínculos a prueba de errores de la organización basada en la nube.

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-SafeLinksPolicy
   [-Identity] <SafeLinksPolicyIdParameter>
   [-AdminDisplayName <String>]
   [-AllowClickThrough <Boolean>]
   [-Confirm]
   [-CustomNotificationText <String>]
   [-DeliverMessageAfterScan <Boolean>]
   [-DisableUrlRewrite <Boolean>]
   [-DoNotRewriteUrls <MultiValuedProperty>]
   [-EnableForInternalSenders <Boolean>]
   [-EnableOrganizationBranding <Boolean>]
   [-EnableSafeLinksForEmail <Boolean>]
   [-EnableSafeLinksForOffice <Boolean>]
   [-EnableSafeLinksForTeams <Boolean>]
   [-ScanUrls <Boolean>]
   [-TrackClicks <Boolean>]
   [-UseTranslatedNotificationText <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Vínculos seguros es una característica de Microsoft Defender para Office 365 que comprueba los vínculos para ver si conducen a sitios web malintencionados. Cuando un usuario hace clic en un vínculo, la dirección URL se vuelve a escribir temporalmente y se comprueba en una lista de sitios web conocidos y malintencionados. Vínculos seguros incluye una característica de seguimiento de URL para determinar quién ha llegado a un sitio web malintencionado.

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-SafeLinksPolicy -Identity "Engineering Block URL" -AllowClickThrough $false

En este ejemplo se modifica la directiva de vínculos seguros existente denominada Dirección URL del bloque de ingeniería para no permitir hacer clic en las direcciones URL originales en las páginas de advertencia.

Parámetros

-AdminDisplayName

El parámetro AdminDisplayName especifica una descripción para la directiva. Si el valor contiene espacios, escriba el valor entre comillas (").

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

-AllowClickThrough

El parámetro AllowClickThrough especifica si se permite a los usuarios hacer clic en la dirección URL original en las páginas de advertencia. Los valores admitidos son:

$true: el usuario puede hacer clic en la dirección URL original. $false: el usuario no puede hacer clic en la dirección URL original.

En PowerShell, el valor predeterminado es $false. En las nuevas directivas de vínculos seguros creadas en el portal de Microsoft 365 Defender, se $true el valor predeterminado.

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

-CustomNotificationText

El texto de notificación personalizado especifica el texto de notificación personalizado que se va a mostrar a los usuarios. Si el valor contiene espacios, escriba el valor entre comillas (").

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

-DeliverMessageAfterScan

El parámetro DeliverMessageAfterScan especifica si se deben entregar mensajes de correo electrónico solo una vez completado el examen de vínculos seguros. Los valores admitidos son:

  • $true: Espere hasta que se complete el examen de vínculos seguros antes de entregar el mensaje. Este es el valor predeterminado. Los mensajes que contienen vínculos malintencionados no se entregan.
  • $false: Si el análisis de vínculos seguros no se puede completar, entregue el mensaje de todos modos.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DisableUrlRewrite

El parámetro DisableUrlRewrite especifica si se deben volver a escribir (encapsular) direcciones URL en los mensajes de correo electrónico. Los valores admitidos son:

  • $true: las direcciones URL de los mensajes no se vuelven a escribir, pero los mensajes siguen siendo examinados por vínculos seguros antes de la entrega. Las comprobaciones de tiempo de clic en los vínculos se realizan mediante la API vínculos seguros en clientes de Outlook compatibles (actualmente, Outlook para Windows y Outlook para Mac).
  • $false: se vuelven a escribir las direcciones URL de los mensajes. Las comprobaciones de API se siguen produciendo en direcciones URL desencapsadas en clientes admitidos si el usuario está en una directiva de vínculos seguros válida.

En PowerShell, el valor predeterminado es $false. En las nuevas directivas de vínculos seguros creadas en el portal de Microsoft 365 Defender, se $true el valor predeterminado.

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

-DoNotRewriteUrls

El parámetro DoNotRewriteUrls especifica las direcciones URL que no se vuelven a escribir mediante el examen de vínculos seguros. La lista de entradas permite a los usuarios incluidos en la directiva acceder a las direcciones URL especificadas que, de lo contrario, estarían bloqueadas por vínculos seguros.

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para obtener más información sobre la sintaxis de entrada, consulte Sintaxis de entrada para la lista "No volver a escribir las direcciones URL siguientes".

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

-EnableForInternalSenders

El parámetro EnableForInternalSenders especifica si la directiva vínculos seguros se aplica a los mensajes enviados entre remitentes internos y destinatarios internos dentro de la misma organización Exchange Online. Los valores admitidos son:

  • $true: la directiva se aplica a remitentes internos y externos. Este es el valor predeterminado.
  • $false: La directiva solo se aplica a remitentes externos.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableOrganizationBranding

El parámetro EnableOrganizationBranding especifica si el logotipo de la organización se muestra en las páginas de advertencia y notificación de vínculos seguros. Los valores admitidos son:

  • $true: La personalización de marca de la organización se muestra en las páginas de advertencia y notificación de vínculos seguros. Antes de configurar este valor, debe seguir las instrucciones de Personalización del tema de Microsoft 365 para que su organización cargue el logotipo de la empresa.
  • $false: La personalización de marca de la organización no se muestra en las páginas de advertencias y notificaciones de vínculos seguros. 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

-EnableSafeLinksForEmail

El parámetro EnableSafeLinksForEmail especifica si se va a habilitar la protección de vínculos seguros para los mensajes de correo electrónico. Los valores admitidos son:

  • $true: Vínculos seguros está habilitado para el correo electrónico. Este es el valor predeterminado. Cuando un usuario hace clic en un vínculo en un correo electrónico, vínculo seguro comprobará el vínculo. Si se detecta que el vínculo es malintencionado, aparece una página de advertencia en el explorador web predeterminado.
  • $false: Vínculos seguros no está habilitado para el correo electrónico.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeLinksForOffice

El parámetro EnableSafeLinksForOffice especifica si se debe habilitar la protección de vínculos seguros para aplicaciones web, móviles o de escritorio de Office compatibles. Los valores admitidos son:

  • $true: El examen de vínculos seguros está habilitado en las aplicaciones de Office. Este es el valor predeterminado. Cuando un usuario abre un archivo en una aplicación de Office compatible y hace clic en un vínculo del archivo, vínculo seguro comprueba el vínculo. Si se detecta que el vínculo es malintencionado, aparece una página de advertencia en el explorador web predeterminado.
  • $false: Vínculos seguros no está habilitado para aplicaciones de Office.

Tenga en cuenta que esta protección se aplica a los vínculos de documentos de Office, no a los vínculos de los mensajes de correo electrónico.

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

-EnableSafeLinksForTeams

El parámetro EnableSafeLinksForTeams especifica si vínculos seguros está habilitado para Microsoft Teams. Los valores admitidos son:

  • $true: Vínculos seguros está habilitado para Teams. Este es el valor predeterminado. Cuando un usuario hace clic en un vínculo en una conversación de Teams, chat en grupo o desde canales, vínculo seguro comprueba el vínculo. Si se detecta que el vínculo es malintencionado, aparece una página de advertencia en el explorador web predeterminado.
  • $false: Vínculos seguros no está habilitado para Teams.
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 de vínculos a prueba de errores que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:SafeLinksPolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ScanUrls

El parámetro ScanUrls especifica si se debe habilitar o deshabilitar el examen en tiempo real de los vínculos en los que se ha hecho clic en los mensajes de correo electrónico. Los valores admitidos son:

  • $true: el examen en tiempo real de los vínculos en los que se ha hecho clic, incluidos los vínculos que apuntan a archivos, está habilitado. Este es el valor predeterminado.
  • $false: el examen en tiempo real de los vínculos en los que se ha hecho clic, incluidos los vínculos que apuntan a archivos, está deshabilitado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-TrackClicks

El parámetro TrackClicks especifica si se debe realizar un seguimiento de los clics del usuario relacionados con la protección de vínculos seguros de vínculos. Los valores admitidos son:

  • $true: se realiza un seguimiento de los clics del usuario. Este es el valor predeterminado.
  • $false: No se realiza el seguimiento de los clics del usuario.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UseTranslatedNotificationText

UseTranslatedNotificationText especifica si se debe usar Microsoft Translator para localizar automáticamente el texto de notificación personalizado que especificó con el parámetro CustomNotificationText. Los valores admitidos son:

  • $true: traducir texto de notificación personalizado al idioma del usuario.
  • $false: no traduzca texto de notificación personalizado al idioma del usuario. 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

-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