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 |