Come pianificare uno script con Task Scheduler

Uno script PowerShell che funziona dalla console spesso fallisce quando lo lancia l’Utilità di pianificazione: gira con un altro account, in un’altra cartella di lavoro, senza profilo, senza unità di rete mappate e senza nessuno che legga gli errori. Questa guida si concentra su quello che è specifico degli script PowerShell (riga di comando corretta, codici di uscita, criterio di esecuzione, credenziali, log) e su come provarli con l’account dell’attività prima di lasciarli girare da soli. Per le opzioni generali delle attività ricorrenti vedi come impostare un Task Scheduler per un’attività ricorrente.

Prerequisiti: lo script provato a mano; la cartella dello script protetta (solo gli amministratori possono modificarlo, altrimenti chiunque può far eseguire codice all’account dell’attività); un account dedicato, meglio se un account gestito di gruppo (gMSA).

1. Scrivi la riga di comando giusta

Campo Valore
Programma powershell.exe (5.1) oppure C:\Program Files\PowerShell\7\pwsh.exe
Argomenti -NoProfile -NonInteractive -File "C:\Script\Report.ps1" -Giorni 7
Inizia in C:\Script
  • -File e non -Command: con -File il codice di uscita dello script (exit 1) diventa l’esito dell’attività; con -Command va propagato a mano e spesso si perde.
  • -NonInteractive: se lo script chiede un input (una conferma, una credenziale) fallisce subito invece di restare appeso per ore.
  • Virgolette attorno al percorso, sempre: un percorso con spazi spezza la riga.
  • Inizia in: senza, la cartella di lavoro è C:\Windows\System32 e i percorsi relativi dello script puntano lì. Meglio ancora usare nello script $PSScriptRoot.

2. Criterio di esecuzione: firma invece di Bypass

Aggiungere -ExecutionPolicy Bypass fa partire qualsiasi script, anche uno modificato da qualcun altro. Se nei server vale RemoteSigned uno script locale non firmato parte comunque; con AllSigned firmalo, come in come configurare la firma digitale degli script PowerShell, e togli il Bypass.

3. Fai uscire lo script con un codice chiaro

$ErrorActionPreference = 'Stop'
Start-Transcript -Path "C:\Script\Log\Report-$(Get-Date -Format yyyyMMdd-HHmm).log"
try {
    # ... lavoro dello script ...
    Write-Output 'Completato'
    $codice = 0
}
catch {
    Write-Output "ERRORE: $($_.Exception.Message)"
    $codice = 1
}
finally {
    Stop-Transcript
}
exit $codice

Con questa struttura ogni esecuzione lascia un log e un errore qualsiasi rende l’attività “non riuscita”, con LastTaskResult uguale a 1 invece di 0. Ricordati di cancellare i log vecchi, per esempio con una riga che elimina quelli più vecchi di 30 giorni.

4. Credenziali e risorse di rete

  • Le unità mappate (Z:) non esistono per l’account dell’attività: usa i percorsi UNC (\\srv-file\report$).
  • Nessuna password nello script. Con un gMSA non serve nessuna password; se lo script deve accedere a un servizio esterno, salva il segreto cifrato per quell’account, come spiegato in come gestire le credenziali in modo sicuro negli script.
  • I moduli installati solo per il tuo utente (-Scope CurrentUser) non li vede l’account dell’attività: installali per tutti gli utenti.

5. Registra l’attività con un gMSA

$azione    = New-ScheduledTaskAction -Execute 'powershell.exe' -WorkingDirectory 'C:\Script' `
               -Argument '-NoProfile -NonInteractive -File "C:\Script\Report.ps1" -Giorni 7'
$trigger   = New-ScheduledTaskTrigger -Weekly -DaysOfWeek Monday -At '07:00'
$principal = New-ScheduledTaskPrincipal -UserId 'CONTOSO\gmsa-report$' -LogonType Password
Register-ScheduledTask -TaskName 'Report settimanale' -TaskPath '\SysAdmin\' `
    -Action $azione -Trigger $trigger -Principal $principal

Il server deve poter leggere la password del gMSA (Test-ADServiceAccount gmsa-report$ restituisce True) e l’account deve avere il diritto Accesso come processo batch.

6. Prova con l’account dell’attività

Start-ScheduledTask -TaskPath '\SysAdmin\' -TaskName 'Report settimanale'
Start-Sleep -Seconds 30
Get-ScheduledTask -TaskPath '\SysAdmin\' -TaskName 'Report settimanale' |
    Get-ScheduledTaskInfo | Select-Object LastRunTime, LastTaskResult

Se fallisce, il motivo quasi sempre è scritto nel log del transcript: percorso non trovato, accesso negato a una cartella, modulo mancante.

Verifica finale: dopo l’avvio manuale LastTaskResult vale 0 e il log riporta “Completato”; provando a far fallire lo script apposta (per esempio un percorso inesistente) LastTaskResult diventa 1. Per accorgersi in automatico delle attività fallite su tutti i server usa lo script pianificazioni Task Scheduler terminate con errore.

Approfondisci

Guide correlate

Script PowerShell pronti all'uso

Per capire i concetti

32 commenti su “Come pianificare uno script con Task Scheduler”

I commenti sono chiusi.

Privacy Policy Cookie Policy