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.
Sintaxe
Default (Default)
New-DkimSigningConfig
[-DomainName] <SmtpDomainWithSubdomains>
[-Enabled] <Boolean>
[-AdminDisplayName <String>]
[-BodyCanonicalization <CanonicalizationType>]
[-Confirm]
[-HeaderCanonicalization <CanonicalizationType>]
[-KeySize <UInt16>]
[-WhatIf]
[<CommonParameters>]
Description
O DKIM no Microsoft 365 é um método de autenticação de e-mail que utiliza uma infraestrutura de chaves públicas (PKI), cabeçalhos de mensagens e registos CNAME no DNS para autenticar o remetente da mensagem, que é 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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro AdminDisplayName especifica uma descrição para a política. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-BodyCanonicalization
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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: as alterações no espaço em branco e as alterações em linhas vazias no final do corpo da mensagem são toleradas. Este valor é a predefinição.
- Simples: só são toleradas alterações em linhas vazias no final do corpo da mensagem.
Propriedades do parâmetro
| Tipo: | CanonicalizationType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainName
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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.
Propriedades do parâmetro
| Tipo: | SmtpDomainWithSubdomains |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Enabled
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Enabled especifica se a política está habilitada. Os valores válidos são:
- $true: a política está ativada.
- $true: a política está habilitada. Esse é o valor padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-HeaderCanonicalization
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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:
- Mais flexíveis: as modificações comuns ao cabeçalho da mensagem são toleradas (por exemplo, a reescritação da linha do campo Cabeçalho, alterações em espaços em branco desnecessários ou linhas vazias e alterações no caso de campos de cabeçalho). Este valor é a predefinição.
- Simples: não são toleradas alterações aos campos de cabeçalho.
Propriedades do parâmetro
| Tipo: | CanonicalizationType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-KeySize
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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 (este é o valor predefinido)
- 2048
As chaves RSA são suportadas. As chaves Ed25519 não são suportadas.
Propriedades do parâmetro
| Tipo: | UInt16 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.