New-DkimSigningConfig

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet New-DkimSigningConfig para criar as configurações de política de assinatura DomainKeys Identified Mail (DKIM) para domínios em uma organização baseada em nuvem.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

New-DkimSigningConfig
   [-DomainName] <SmtpDomainWithSubdomains>
   [-Enabled] <Boolean>
   [-AdminDisplayName <String>]
   [-BodyCanonicalization <CanonicalizationType>]
   [-Confirm]
   [-HeaderCanonicalization <CanonicalizationType>]
   [-KeySize <UInt16>]
   [-WhatIf]
   [<CommonParameters>]

Description

O DKIM em Microsoft 365 é um método de autenticação por email que usa uma PKI (infraestrutura de chave pública), cabeçalhos de mensagem e registros CNAME no DNS para autenticar o remetente de mensagens, que está carimbado no campo de cabeçalho DKIM-Signature. O DKIM ajuda a impedir endereços de email de remetente falsificados (também conhecido como falsificação) verificando que o domínio no endereço From coincide com o domínio no campo do cabeçalho DKIM-Signature.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

New-DkimSigningConfig -DomainName contoso.com -Enabled $true

Este exemplo habilita a mensagem DKIM de assinatura para o domínio contoso.com.

Parâmetros

-AdminDisplayName

O parâmetro AdminDisplayName especifica uma descrição para a política. Se o valor contiver espaços, coloque-o entre aspas (").

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

O parâmetro BodyCanonicalization especifica o algoritmo de canonização que é usado para criar e verificar a parte de corpo de mensagem da assinatura DKIM. Este valor efetivamente controla a sensibilidade do DKIM a alterações ao corpo da mensagem em trânsito. Os valores válidos são:

  • Relaxado: alterações no whitespace e alterações em linhas vazias no final do corpo da mensagem são toleradas. Esse é o valor padrão.
  • Simples: somente alterações em linhas vazias no final do corpo da mensagem são toleradas.
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

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o 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

O parâmetro DomainName especifica o domínio de sua organização para o qual você deseja habilitar assinatura de mensagens DKIM.

Por padrão, a assinatura de mensagem DKIM é habilitada para o domínio inicial *.onmicrosoft.com da organização (por exemplo, contoso.onmicrosoft.com).

Para domínios personalizados que não têm as mensagens de assinatura DKIM habilitadas, as assinaturas DKIM para o domínio *.onmicrosoft.com são adicionadas às mensagens.

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

O parâmetro Enabled especifica se a política está habilitada. Os valores válidos são:

  • $true: a política está habilitada. Esse é o valor padrão.
  • $true: a política está habilitada. Esse é o valor padrão.
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

O parâmetro HeaderCanonicalization especifica o algoritmo de canonização que é usado para criar e verificar a parte do cabeçalho de mensagem da assinatura DKIM. Este valor efetivamente controla a sensibilidade do DKIM a alterações aos cabeçalhos de mensagem em trânsito. Os valores válidos são:

  • Relaxado: modificações comuns no cabeçalho da mensagem são toleradas (por exemplo, reembrulho de linha de campo cabeçalho, alterações no whitespace desnecessário ou linhas vazias e alterações no caso de campos de cabeçalho). Esse é o valor padrão.
  • Simples: nenhuma alteração nos campos de cabeçalho é tolerada.
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

O parâmetro KeySize especifica o tamanho em bits da chave pública que é usada na política de assinatura DKIM. Os valores válidos são 1024 ou 2048.

Há suporte para chaves RSA; Não há suporte para chaves 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

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

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