Notifica su Teams per eventi critici rilevati

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.

Prerequisiti Un connettore webhook in ingresso configurato sul canale Teams

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

ParametroTipoObbligatorioValore predefinito
-Titolotestosì—
-Messaggiotestosì—
-ColoretestonoFF0000

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
    }
}

Approfondimenti

Privacy Policy Cookie Policy