Funzione riutilizzabile per inviare un file di report come allegato email, pronta da richiamare da altri script.
Lo script definisce una funzione riutilizzabile che invia un’email con un file allegato (tipicamente un report CSV o HTML generato da un altro script di questa raccolta), pensata per essere richiamata al termine di qualsiasi script di reportistica.
Come si usa
Il file non va eseguito da solo: definisce la funzione Invia-ReportViaEmail, da caricare in un altro script o nella console con il dot-sourcing (il punto seguito da uno spazio) e poi richiamare quando serve:
. .\Invia-ReportEmail.ps1
Invia-ReportViaEmail -Destinatario "<Destinatario>" -Oggetto "<Oggetto>" -Allegato "<Allegato>"
Sostituisci i valori tra < > con i tuoi.
Prima dell’uso personalizza le variabili in testa al file: $SmtpServer, $Mittente.
Parametri della funzione Invia-ReportViaEmail
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-Destinatario | testo | sì | — | passato a Send-MailMessage -To |
-Oggetto | testo | sì | — | passato a Send-MailMessage -Subject |
-Allegato | testo | sì | — | passato a Send-MailMessage -Attachments |
-Corpo | testo | no | In allegato il report richiesto, generato automaticamente. | passato a Send-MailMessage -Body |
Cosa restituisce
- Un messaggio email inviato tramite il server SMTP indicato nello script.
- A video, un riepilogo a colori: rosso per errori e problemi, verde quando l’esito è positivo.
Requisiti
- Un server SMTP raggiungibile che accetti l’invio (relay) dal computer su cui gira lo script.
- Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con
Unblock-File .\Invia-ReportEmail.ps1.
I comandi usati dallo script
Send-MailMessage: invia un’email tramite un server SMTP. Microsoft lo considera obsoleto perché non garantisce connessioni sicure: va bene con un relay SMTP interno, non per inviare direttamente da Microsoft 365.
Il codice completo
È lo stesso contenuto del file scaricabile (36 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Funzione riutilizzabile per inviare un file di report come allegato email.
.NOTES
Personalizza SmtpServer e Mittente prima dell'uso, poi importa questo file
(dot-sourcing: . .\Invia-ReportEmail.ps1) da altri script per usare la funzione.
#>
$SmtpServer = "smtp.azienda.local"
$Mittente = "reportistica-it@azienda.local"
function Invia-ReportViaEmail {
param(
[Parameter(Mandatory=$true)]
[string]$Destinatario,
[Parameter(Mandatory=$true)]
[string]$Oggetto,
[Parameter(Mandatory=$true)]
[string]$Allegato,
[string]$Corpo = "In allegato il report richiesto, generato automaticamente."
)
if (-not (Test-Path $Allegato)) {
Write-Host "File allegato non trovato: $Allegato" -ForegroundColor Red
return
}
try {
Send-MailMessage -From $Mittente -To $Destinatario -Subject $Oggetto -Body $Corpo `
-Attachments $Allegato -SmtpServer $SmtpServer -Encoding UTF8
Write-Host "Email inviata a $Destinatario con allegato $Allegato" -ForegroundColor Green
}
catch {
Write-Host "Errore nell'invio email: $_" -ForegroundColor Red
}
}
Approfondimenti
- Tutte le guide Automazione
- Gli altri script Automazione e Reportistica