New-SafeLinksPolicy
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet New-SafeLinksPolicy para crear directivas de vínculos seguros en 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
New-SafeLinksPolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-MakeBuiltInProtection]
[-RecommendedPolicyType <RecommendedPolicyType>]
[-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.
Las nuevas directivas que cree con este cmdlet no se aplican a los usuarios y no son visibles en los centros de administración. Debe usar el parámetro SafeLinksPolicy en los cmdlets New-SafeLinksRule o Set-SafeLinksRule para asociar la directiva a una regla.
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
New-SafeLinksPolicy -Name "Marketing Block URL" -EnableSafeLinksForEmail $true -AllowClickThrough $falseEn este ejemplo se crea una nueva directiva de vínculos seguros denominada Dirección URL de bloque de marketing con las siguientes opciones:
- La directiva está habilitada.
- No se permite a los usuarios hacer clic en la dirección URL original.
- Se realiza un seguimiento de los clics del usuario en las direcciones URL. Este es el valor predeterminado del parámetro TrackClicks, por lo que no es necesario especificarlo.
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 los usuarios pueden 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. Los mensajes que contienen vínculos malintencionados no se entregan. Este es el valor predeterminado.
- $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. Este es el valor predeterminado.
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.
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 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 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 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 |
-MakeBuiltInProtection
El modificador MakeBuiltInProtection se usa para la creación de directivas de protección integradas como parte de las directivas de seguridad preestablecidas. No use este interruptor usted mismo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
El parámetro Name especifica un nombre único para la directiva Vínculos seguros. Si el valor contiene espacios, escriba el valor entre comillas (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RecommendedPolicyType
El parámetro RecommendedPolicyType se usa para la creación de directivas estándar y estricta como parte de las directivas de seguridad preestablecidas. No use este parámetro usted mismo.
| Type: | RecommendedPolicyType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 mensajes de clics del usuario. Este es el valor predeterminado.
- $false: No se realiza el seguimiento de los mensajes de 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 |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de