Send-MailMessage

Send-MailMessage [-To] <string[]> [-Subject] <string> -From <string> [[-Body] <string>] [[-SmtpServer] <string>] [-Attachments <string[]>] [-Bcc <string[]>] [-BodyAsHtml] [-Cc <string[]>] [-Credential <PSCredential>] [-DeliveryNotificationOption {<None> | <OnSuccess> | <OnFailure> | <Delay> | <Never>}] [-Encoding <Encoding>] [-Priority {<Normal> | <Low> | <High>}] [-UseSsl] [<CommonParameters>]

Il cmdlet Send-MailMessage invia un messaggio di posta elettronica da Windows PowerShell.

-Attachments <string[]>

Specifica il percorso e i nomi dei file da allegare al messaggio di posta elettronica. È possibile utilizzare questo parametro o reindirizzare i percorsi e i nomi file a Send-MailMessage.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	true (ByValue)
Accettare caratteri jolly?	false

-Bcc <string[]>

Specifica gli indirizzi di posta elettronica che ricevono una copia del messaggio ma non sono elencati come destinatari del messaggio. Immettere i nomi (facoltativo) e gli indirizzi di posta elettronica, ad esempio "Nome <qualcuno@esempio.com>".

Obbligatorio?	false
Posizione?	named
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Body <string>

Specifica il corpo (contenuto) del messaggio di posta elettronica.

Obbligatorio?	false
Posizione?	3
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-BodyAsHtml

Indica che il valore del parametro Body contiene HTML.

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Cc <string[]>

Specifica gli indirizzi di posta elettronica a cui viene inviata una copia per conoscenza (Cc) del messaggio di posta elettronica. Immettere i nomi (facoltativo) e gli indirizzi di posta elettronica, ad esempio "Nome <qualcuno@esempio.com>".

Obbligatorio?	false
Posizione?	named
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01". In alternativa, immettere un oggetto PSCredential, ad esempio uno del cmdlet Get-Credential.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Current user
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-DeliveryNotificationOption <DeliveryNotificationOptions>

Specifica le opzioni di notifica di recapito per il messaggio di posta elettronica. È possibile specificare più valori. "None" è il valore predefinito. L'alias per questo parametro è "dno".

Le notifiche di recapito vengono inviate in un messaggio di posta elettronica all'indirizzo specificato nel valore del parametro To.

I valori validi sono:

-- None: nessuna notifica.

-- OnSuccess: la notifica viene inviata se la consegna ha avuto esito positivo.

-- OnFailure: la notifica viene inviata se la consegna ha avuto esito negativo.

-- Delay: la notifica viene inviata se la consegna è ritardata.

-- Never: la notifica non viene mai inviata.

Obbligatorio?	false
Posizione?	named
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Encoding <Encoding>

Specifica la codifica utilizzata per il corpo e l'oggetto del messaggio. I valori validi sono ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default e OEM. Il valore predefinito è ASCII.

Obbligatorio?	false
Posizione?	named
Valore predefinito	ASCII
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-From <string>

Specifica l'indirizzo da cui viene inviata la posta elettronica. Immettere un nome (facoltativo) e un indirizzo di posta elettronica, ad esempio "Nome <qualcuno@esempio.com>". Questo parametro è obbligatorio.

Obbligatorio?	true
Posizione?	named
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Priority <MailPriority>

Specifica la priorità del messaggio di posta elettronica. I valori validi sono Normal, High e Low. Normal è il valore predefinito.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Normal.
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-SmtpServer <string>

Specifica il nome del server SMTP che invia il messaggio di posta elettronica.

Il valore predefinito è il valore della variabile di preferenza $PSEmailServer. Se la variabile non è impostata e questo parametro viene omesso, il comando ha esito negativo.

Obbligatorio?	false
Posizione?	4
Valore predefinito	$PSEmailServer
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Subject <string>

Specifica l'oggetto del messaggio di posta elettronica. Questo parametro è obbligatorio.

Obbligatorio?	true
Posizione?	2
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-To <string[]>

Specifica gli indirizzi a cui viene inviata la posta elettronica. Immettere i nomi (facoltativo) e gli indirizzi di posta elettronica, ad esempio "Nome <qualcuno@esempio.com>". Questo parametro è obbligatorio.

Obbligatorio?	true
Posizione?	1
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-UseSsl

Utilizza il protocollo SSL (Secure Sockets Layer) per stabilire una connessione al computer remoto e inviare il messaggio. Per impostazione predefinita SSL non viene utilizzato.

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String

È possibile reindirizzare il percorso e i nomi dei file allegati a Send-MailMessage.

Output

Nessuno

Questo cmdlet non genera alcun output.

C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "User02 <user02@example.com>" -subject "Test mail"

Descrizione
-----------
Questo comando invia un messaggio di posta elettronica da Utente01 a Utente02. 

Il messaggio ha un oggetto, obbligatorio, ma non ha un corpo, facoltativo. Inoltre, poiché il parametro SmtpServer non è specificato, Send-MailMessage utilizza il valore della variabile di preferenza $PSEmailServer per il server SMTP.

C:\PS>send-mailmessage -from "User01 <user01@example.com>" -to "User02 <user02@example.com>", "User03 <user03@example.com>" -subject "Sending the Attachment" -body "Forgot to send the attachment. Sending now." -Attachment "data.csv" -priority High -dno onSuccess, onFailure -smtpServer smtp.fabrikam.com

Descrizione
-----------
Questo comando invia un messaggio di posta elettronica con un allegato da User01 a due altri utenti. 

Specifica il valore di priorità "High" e richiede una notifica di recapito tramite posta elettronica quando il recapito ha esito positivo o negativo.

C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "ITGroup <itdept@example.com>" -cc "User02 <user02@example.com>" -bcc ITMgr <itmgr@example.com> -subject "Don't forget today's meeting!" -credential domain01\admin01 -useSSL

Descrizione
-----------
Questo comando invia un messaggio di posta elettronica da Utente01 alla lista di distribuzione ITGroup con una copia (Cc) a Utente02 e una copia per conoscenza nascosta (Ccn) al responsabile IT (ITMgr).

Utilizza le credenziali di un amministratore di dominio e il parametro UseSSL.

Send-MailMessage

Sintassi

Descrizione

Parametri