New-MailMessage
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet New-MailMessage per creare un messaggio di posta elettronica per la cassetta postale utente specificata e inserire il messaggio di posta elettronica nella cartella Bozze della cassetta postale dell'utente.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-MailMessage
[[-Body] <String>]
[-BodyFormat <MailBodyFormat>]
[-Confirm]
[-DomainController <Fqdn>]
[-Subject <String>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Se il cmdlet viene eseguito senza specificare i parametri Subject o Body, nella cartella Bozze dell'utente viene inserito un messaggio di posta elettronica vuoto.
È 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-MailMessage -Subject "Delivery Report" -Body "Click here to view this report" -Mailbox tony
In Exchange Server 2010 questo esempio crea un messaggio nella cartella Bozze della cassetta postale di Tony, con l'oggetto e il corpo specificati dai parametri Subject e Body. Il rendering del corpo del messaggio viene eseguito in testo normale poiché non è specificato alcun formato per il corpo del messaggio.
Esempio 2
New-MailMessage -Subject "Delivery Report" -Body "Click here to view this report"
In questo esempio si crea un messaggio di posta elettronica nella cartella Bozze con l'oggetto e il corpo specificati dai parametri Subject e Body. Il rendering del corpo del messaggio viene eseguito in testo normale poiché non è specificato alcun formato per il corpo del messaggio.
Esempio 3
New-MailMessage -Mailbox tony@contoso.com
In Exchange Server 2010 questo esempio crea un messaggio vuoto nella cartella Bozze della cassetta postale di Tony perché non viene specificato alcun oggetto o corpo del messaggio.
Esempio 4
New-MailMessage
In questo esempio viene creato un messaggio di posta elettronica vuoto nella cartella Bozze perché non è stato specificato alcun oggetto o corpo del messaggio.
Esempio 5
New-MailMessage -Subject "Delivery Information" -Body "Click here to see details" -Mailbox tony -BodyFormat Html
In Exchange Server 2010 questo esempio crea un messaggio nella cartella Bozze della cassetta postale di Tony con l'oggetto e il corpo specificati dai parametri Subject e Body. Il rendering del corpo del messaggio viene eseguito in formato HTML.
Esempio 6
New-MailMessage -Subject "Delivery Information" -Body "Click here to see details" -BodyFormat Html
In questo esempio si crea un messaggio di posta elettronica nella cartella Bozze con l'oggetto e il corpo specificati dai parametri Subject e Body. Il rendering del corpo del messaggio viene eseguito in formato HTML.
Parametri
-Body
Il parametro Body consente di specificare il contenuto della sezione corpo del nuovo messaggio di posta elettronica.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BodyFormat
Il parametro BodyFormat consente di specificare il formato del corpo del messaggio. I valori possono essere PlainTextRtf (Rich Text Format) o Html. Per impostazione predefinita, se il parametro BodyFormat non viene specificato quando è utilizzato il parametro Body, il corpo del messaggio viene rappresentato come testo normale.
Type: | MailBodyFormat |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Subject
Il parametro Subject consente di specificare il contenuto del campo Oggetto del nuovo messaggio di posta elettronica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.