New-DkimSigningConfig

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

Use el cmdlet New-DkimSigningConfig para crear la configuración de directiva de firma de DKIM (DomainKeys Identified Mail) para dominios en una 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-DkimSigningConfig
   [-DomainName] <SmtpDomainWithSubdomains>
   [-Enabled] <Boolean>
   [-AdminDisplayName <String>]
   [-BodyCanonicalization <CanonicalizationType>]
   [-Confirm]
   [-HeaderCanonicalization <CanonicalizationType>]
   [-KeySize <UInt16>]
   [-WhatIf]
   [<CommonParameters>]

Description

DKIM en Microsoft 365 es un método de autenticación por correo electrónico que usa una infraestructura de clave pública (PKI), encabezados de mensaje y registros CNAME en DNS para autenticar al remitente del mensaje, que se marca en el campo de encabezado DKIM-Signature. DKIM ayuda a prevenir la falsificación de direcciones de correo electrónico del remitente (lo que también se conoce como suplantación de identidad) al comprobar que el dominio en la dirección de From coincide con el dominio en el campo de encabezado de DKIM-Signature.

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-DkimSigningConfig -DomainName contoso.com -Enabled $true

En este ejemplo se habilita la firma de mensajes con DKIM para el dominio contoso.com.

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, Exchange Online Protection

-BodyCanonicalization

El parámetro BodyCanonicalization especifica el algoritmo de canonización que se usa para crear y comprobar la parte del cuerpo del mensaje de la firma de DKIM. Este valor controla de manera eficaz la sensibilidad de DKIM a los cambios en el cuerpo del mensaje en tránsito. Los valores admitidos son:

  • Relajado: se toleran los cambios en el espacio en blanco y los cambios en las líneas vacías al final del cuerpo del mensaje. Este es el valor predeterminado.
  • Simple: solo se toleran los cambios en las líneas vacías al final del cuerpo del mensaje.
Type:CanonicalizationType
Position:Named
Default value:None
Required:False
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, 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, Exchange Online Protection

-DomainName

El parámetro DomainName especifica el dominio en su organización que quiere habilitar para la firma de mensajes con DKIM.

De forma predeterminada, la firma de mensajes con DKIM está habilitada para el dominio inicial *.onmicrosoft.com en la organización (por ejemplo, contoso.onmicrosoft.com).

En el caso de los dominios personalizados que no tengan habilitada la firma de mensajes con DKIM, se agrega a los mensajes las firmas de DKIM del dominio *.onmicrosoft.com.

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

-Enabled

El parámetro Enabled especifica si la directiva está habilitada. Los valores admitidos son:

  • $true: la directiva está habilitada. Este es el valor predeterminado.
  • $true: la directiva está habilitada. Es el valor predeterminado.
Type:Boolean
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-HeaderCanonicalization

El parámetro HeaderCanonicalization especifica el algoritmo de canonización que se usa para crear y comprobar la parte del encabezado del mensaje de la firma de DKIM. Este valor controla de manera eficaz la sensibilidad de DKIM para los cambios en los encabezados de mensajes en tránsito. Los valores admitidos son:

  • Relajado: se toleran las modificaciones comunes en el encabezado del mensaje (por ejemplo, la reasignación de la línea de campo de encabezado, los cambios en espacios en blanco innecesarios o las líneas vacías, y los cambios en caso de campos de encabezado). Este es el valor predeterminado.
  • Simple: no se toleran cambios en los campos de encabezado.
Type:CanonicalizationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-KeySize

El parámetro KeySize especifica el tamaño en bits de la clave pública que se usa en la directiva de firma de DKIM. Los valores válidos son 1024 o 2048.

Se admiten claves RSA; No se admiten las claves Ed25519.

Type:UInt16
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection