New-DkimSigningConfig

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet New-DkimSigningConfig per creare le impostazioni dei criteri di accesso DKIM (DomainKeys Identified Mail) per i domini presenti nell'organizzazione basata sul cloud.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

DKIM in Microsoft 365 è un metodo di autenticazione tramite posta elettronica che usa un'infrastruttura a chiave pubblica (PKI), intestazioni di messaggio e record CNAME in DNS per autenticare il mittente del messaggio, che viene contrassegnato nel campo dell'intestazione DKIM-Signature. DKIM blocca gli indirizzi falsificati dei mittenti (lo spoofing) verificando che il dominio dell'indirizzo From corrisponda a quello presente nell'intestazione DKIM-Signature.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

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

In questo esempio viene abilitata la firma DKIM dei messaggi per il dominio contoso.com.

Parametri

-AdminDisplayName

Il parametro AdminDisplayName specifica una descrizione per i criteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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

Il parametro BodyCanonicalization specifica l'algoritmo di canonizzazione usato per creare e verificare il corpo del messaggio relativo alla firma DKIM. Il valore controlla la reattività di DKIM ai cambiamenti apportati al corpo del messaggio in transito. I valori validi sono:

  • Rilassato: le modifiche negli spazi vuoti e nelle righe vuote alla fine del corpo del messaggio vengono tollerate. Questo è il valore predefinito.
  • Semplice: vengono tollerate solo le modifiche nelle righe vuote alla fine del corpo del messaggio.
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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Il parametro DomainName specifica il dominio della propria organizzazione per il quale abilitare la firma DKIM dei messaggi.

Per impostazione predefinita, la firma DKIM dei messaggi è abilitata per il dominio che inizia con *.onmicrosoft.com nell'organizzazione (ad esempio, contoso.onmicrosoft.com).

Per i domini personalizzati in cui la firma DKIM dei messaggi non è abilitata, le firme DKIM per *.onmicrosoft.com vengono aggiunte ai messaggi.

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

Il parametro Enabled consente di specificare se il criterio è abilitato. I valori validi sono:

  • $true: i criteri sono abilitati. Questo è il valore predefinito.
  • $true: il criterio è abilitato. Questo è il valore predefinito.
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

Il parametro HeaderCanonicalization specifica l'algoritmo di canonizzazione usato per creare e verificare l'intestazione del messaggio relativo alla firma DKIM. Il valore controlla la reattività di DKIM ai cambiamenti apportati all'intestazione del messaggio in transito. I valori validi sono:

  • Rilassato: le modifiche comuni all'intestazione del messaggio vengono tollerate (ad esempio, il rewrapping della riga del campo intestazione, le modifiche negli spazi vuoti non necessari o nelle righe vuote e le modifiche nel caso per i campi di intestazione). Questo è il valore predefinito.
  • Semplice: non vengono tollerate modifiche ai campi di intestazione.
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

Il parametro KeySize specifica la dimensione (espressa in bit) della chiave pubblica che viene usata nel criterio di accesso DKIM. I valori validi sono 1024 o 2048.

Le chiavi RSA sono supportate; Le chiavi Ed25519 non sono supportate.

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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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