Send-IrionDQMail

Navigation:  Il Package: lavorazione dei dati > Arricchimento del Package > Script Engine > I Commandlet di IrionEDM >

Send-IrionDQMail

Previous pageReturn to chapter overviewNext page

Lo Script Engine consente l’invio automatizzato di e-mail dall'interno di un Package.

A tal fine, IrionEDM mette a disposizione dell'utente il cmdlet Send-IrionDQMail. Esso accetta in input i parametri elencati nella seguente tabella.

 

Nome

Descrizione

From

Indirizzo e-mail del mittente.

To

Indirizzo e-mail del destinatario. È possibile anche specificare due o più destinatari mediante un array di indirizzi.

ToList

Indirizzo e-mail del destinatario, impostato attraverso la Distribution List definita a livello di Catalog. È possibile anche specificare due o più destinatari  mediante un array di stringhe.

Cc

Indirizzo e-mail del destinatario della copia conoscenza. È possibile anche specificare due o più destinatari mediante un array di indirizzi.

CcList

Indirizzo e-mail del destinatario della copia conoscenza, impostato attraverso la Distribution List definita a livello di Catalog. È possibile anche specificare due o più destinatari  mediante un array di stringhe.

Bcc

Indirizzo e-mail del destinatario della copia conoscenza nascosta. È possibile anche specificare due o più destinatari mediante un array di indirizzi.

BccList

Indirizzo e-mail del destinatario della copia conoscenza nascosta, impostato attraverso la Distribution List definita a livello di Catalog. È possibile anche specificare due o più destinatari  mediante un array di stringhe.

Attachments

Percorso assoluto di un eventuale allegato. È possibile anche specificare due o più allegati mediante un array di path.

Subject

Oggetto della mail.

Body

Corpo della mail.

BodyAsHtml

Se presente forza la formattazione html del corpo della mail.

Encoding

Codifica da applicare al testo della mail (e.g. [System.Text.Encoding]::UTF8).

Priority

Priorità della mail. Può assumere i valori:

[System.Net.Mail.MailPriority]::High

[System.Net.Mail.MailPriority]::Normal

[System.Net.Mail.MailPriority]::Low

Default

Parametro privo di valore. Se presente forza l'utilizzo di un server SMTP  (Simple Mail Transfer Protocol) predefinito a livello di Catalog, nel tab Mail Servers dei Catalog Settings.

SmtpServer

Server SMTP. Non specificare in caso di presenza del parametro Default.

Credential

Oggetto PSCredential contenente Nome utente e password per l'accesso al server SMTP. Non specificare in caso di presenza del parametro Default.

SmtpPort

Porta SMTP. Non specificare in caso di presenza del parametro Default.

UseSsl

Parametro privo di valore. Se presente forza l'utilizzo del protocollo di sicurezza SSL (Secure Sockets Layer).

Delivery

Notification

Options

Opzioni relative alla ricevuta di ritorno. Può assumere i valori:

[System.Net.Mail.MailPriority]::Delay

(Notifica se la consegna è posticipata);

[System.Net.Mail.MailPriority]::Never

(Non viene inviata alcuna notifica);

[System.Net.Mail.MailPriority]::OnFailure

(Notifica se la consegna è fallita);

[System.Net.Mail.MailPriority]::OnSuccess

(Notifica se la consegnaha avuto successo);

 

info

Il solo parametro in input obbligatorio è l'indirizzo e-mail del destinatario.

 

ex

ESEMPIO DI UTILIZZO

Supponiamo di voler inviare una e-mail, corredata di oggetto e corpo del messaggio, mediante uno Script Engine. La sintassi corretta è:

$from = 'sender@mydomain.com'

$to = 'addressee@sample.com'

$subject = 'Hello'

$body = 'Hello, this is the message body.'

Send-IrionDQMail  -from $from  `

-to $to  `

-subject $subject  `

-body $body  `

-Default

dove i termini preceduti da "$" identificano variabili PowerShell, mentre il carattere "`" (backtick: ALT + 96) consente la scrittura di comandi multi-linea.