Test-Message
Questo cmdlet funziona solo nel servizio basato sul cloud.
Usare il cmdlet Test-Message per simulare e segnalare gli effetti delle regole del flusso di posta (regole di trasporto) e delle regole DLP unificate sui messaggi di posta elettronica di test. Poiché questo cmdlet introduce la posta elettronica nella pipeline di valutazione DLP, nel messaggio di test possono essere eseguite azioni come Block, Moderate e così via. Le notifiche correlate vengono inviate anche a tutti i destinatari configurati.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
TransportRules
Test-Message
-Recipients <ProxyAddressCollection>
-SendReportTo <RecipientIdParameter>
-TransportRules
[-Confirm]
[-Force]
[-MessageFileData <Byte[]>]
[-Sender <SmtpAddress>]
[-UnifiedDlpRules]
[-WhatIf]
[<CommonParameters>]
UnifiedDLPRules
Test-Message
-Recipients <ProxyAddressCollection>
-SendReportTo <RecipientIdParameter>
-UnifiedDlpRules
[-Confirm]
[-Force]
[-MessageFileData <Byte[]>]
[-Sender <SmtpAddress>]
[-WhatIf]
[<CommonParameters>]
Descrizione
È necessario eseguire questo cmdlet con l'opzione TransportRules o UnifiedDlpRules.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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
$data = [System.IO.File]::ReadAllBytes('C:\Data\test.eml')
Test-Message -MessageFileData $data -Sender megan@contoso.com -Recipients adele@contoso.com -SendReportTo admin@contoso.com -TransportRules -UnifiedDlpRules
In questo esempio viene usato il file del messaggio test.eml in C:\Data per testare le regole del flusso di posta e le regole DLP unificate per il mittente megan@contoso.com al destinatario adele@contoso.com. Il report dei risultati viene inviato a admin@contoso.com.
Parametri
-Confirm
Applicabile: Exchange Server 2013, Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'opzione Force consente di specificare se eliminare i messaggi di avviso o di conferma. È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MessageFileData
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro MessageFileData specifica il file di messaggio .eml da testare.
Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($data).
Proprietà dei parametri
| Tipo: | Byte[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Recipients
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro Recipients consente di specificare l'indirizzo di posta elettronica del destinatario da utilizzare per il messaggio di test.
È possibile indicare più indirizzi di posta elettronica separati da virgole.
Proprietà dei parametri
| Tipo: | ProxyAddressCollection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Sender
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro Sender consente di specificare l'indirizzo di posta elettronica del mittente da usare per il messaggio di test.
Proprietà dei parametri
| Tipo: | SmtpAddress |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SendReportTo
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro SendReportTo consente di specificare l'indirizzo di posta elettronica di destinazione per i risultati del comando.
Proprietà dei parametri
| Tipo: | RecipientIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TransportRules
Applicabile: Exchange Server 2013, Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'opzione TransportRules specifica che si desidera testare le regole del flusso di posta. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TransportRules
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UnifiedDlpRules
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'opzione UnifiedDlpRules specifica che si desidera unificare le regole di prevenzione della perdita dei dati. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
UnifiedDLPRules
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
TransportRules
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Server 2013, Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.