Invia una notifica su un canale Microsoft Teams tramite webhook quando viene rilevato un evento critico.
Lo script definisce una funzione riutilizzabile che invia un messaggio formattato a un canale Microsoft Teams tramite un webhook in ingresso, pensata per essere richiamata da altri script quando rilevano una condizione critica.
Come si usa
Il file non va eseguito da solo: definisce la funzione Invia-NotificaTeams, da caricare in un altro script o nella console con il dot-sourcing (il punto seguito da uno spazio) e poi richiamare quando serve:
. .\Notifica-TeamsEventiCritici.ps1
Invia-NotificaTeams -Titolo "<Titolo>" -Messaggio "<Messaggio>"
Sostituisci i valori tra < > con i tuoi.
Prima dell’uso personalizza le variabili in testa al file: $WebhookUrl.
Parametri della funzione Invia-NotificaTeams
| Parametro | Tipo | Obbligatorio | Valore predefinito |
|---|---|---|---|
-Titolo | testo | sì | — |
-Messaggio | testo | sì | — |
-Colore | testo | no | FF0000 |
Cosa restituisce
- A video, un riepilogo a colori: verde quando l’esito è positivo, rosso per errori e problemi.
Requisiti
- Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con
Unblock-File .\Notifica-TeamsEventiCritici.ps1.
I comandi usati dallo script
Invoke-RestMethod: chiama un servizio web (REST) e converte la risposta JSON in oggetti.
Il codice completo
È lo stesso contenuto del file scaricabile (33 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Funzione riutilizzabile per inviare una notifica a un canale Microsoft Teams tramite webhook.
.NOTES
Sostituisci $WebhookUrl con l'URL del connettore webhook configurato sul canale Teams.
#>
$WebhookUrl = "https://azienda.webhook.office.com/webhookb2/INSERISCI-IL-TUO-URL"
function Invia-NotificaTeams {
param(
[Parameter(Mandatory=$true)]
[string]$Titolo,
[Parameter(Mandatory=$true)]
[string]$Messaggio,
[string]$Colore = "FF0000"
)
$payload = @{
"@type" = "MessageCard"
"@context" = "http://schema.org/extensions"
themeColor = $Colore
title = $Titolo
text = $Messaggio
} | ConvertTo-Json
try {
Invoke-RestMethod -Uri $WebhookUrl -Method Post -Body $payload -ContentType "application/json"
Write-Host "Notifica inviata a Teams: $Titolo" -ForegroundColor Green
}
catch {
Write-Host "Errore nell'invio della notifica a Teams: $_" -ForegroundColor Red
}
}