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
-Fileil codice di uscita dello script (exit 1) diventa l’esito dell’attività; con-Commandva 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\System32e 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
- Come impostare un Task Scheduler per un’attività ricorrente
- Come usare i job PowerShell per eseguire attività in parallelo
- Come integrare uno script PowerShell con Azure Automation
Script PowerShell pronti all'uso
Per capire i concetti
32 commenti su “Come pianificare uno script con Task Scheduler”
I commenti sono chiusi.