Set-ScheduledJob

Specifica i valori per i parametri dello script specificati dal parametro FilePath o per il comando specificato dal parametro ScriptBlock .

Specifica il meccanismo usato per autenticare le credenziali dell'utente. I valori validi per questo parametro sono:

• Default
• Basic
• Credssp
• Digest
• Kerberos
• Negotiate
• NegotiateWithImplicitCredential

Il valore predefinito è Default. Per altre informazioni sui valori di questo parametro, vedere AuthenticationMechanism Enumeration in PowerShell SDK.

Elimina la cronologia di esecuzione corrente e i risultati salvati del processo pianificato.

La cronologia di esecuzione del processo e i risultati del processo vengono salvati con il processo pianificato nella $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory nel computer in cui viene creato il processo. Per visualizzare la cronologia di esecuzione, usare il Get-Job cmdlet . Per ottenere i risultati del processo, usare il Receive-Job cmdlet .

Questo parametro non influenza gli eventi che l'Utilità di pianificazione scrive nei log eventi di Windows e non impedisce di salvare i risultati del processo in Windows PowerShell. Per gestire il numero di risultati del processo salvati, usare il parametro MaxResultCount .

Specifica un account utente che dispone dell'autorizzazione per eseguire il processo pianificato. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio User01 o Domain01\User01, oppure immettere un oggetto PSCredential , ad esempio uno del Get-Credential cmdlet. Se si digita solo un nome utente, viene richiesta una password.

Specifica uno script eseguito dal processo pianificato. Immettere il percorso di un file con estensione ps1 nel computer locale. Per specificare i valori predefiniti per i parametri dello script, usare il parametro ArgumentList . Ogni processo pianificato deve avere un valore ScriptBlock o FilePath .

Specifica il percorso completo di uno script di Windows PowerShell (.ps1). Lo script di inizializzazione viene eseguito nella sessione creata per il processo in background prima dei comandi specificati dal parametro ScriptBlock o dallo script specificato dal parametro FilePath . È possibile usare lo script di inizializzazione per configurare la sessione, ad esempio aggiungere file, funzioni e alias, creare directory o controllare prerequisiti.

Per specificare uno script che esegue i comandi del processo primario, usare il parametro FilePath .

Se lo script di inizializzazione genera un errore, incluso un errore non irreversibile, l'istanza corrente del processo pianificato non viene eseguita e il relativo stato è Non riuscito.

Specifica il processo pianificato da modificare. Immettere una variabile contenente oggetti ScheduledJobDefinition o digitare un comando o un'espressione che ottiene oggetti ScheduledJobDefinition , ad esempio un Get-ScheduledJob comando. È anche possibile inviare tramite pipe un oggetto ScheduledJobDefinition a Set-ScheduledJob.

Se si specificano più processi pianificati, Set-ScheduledJob apporta le stesse modifiche a tutti i processi.

Specifica quante voci di risultato del processo vengono mantenute per il processo pianificato. Il valore predefinito è 32.

Windows PowerShell salva la cronologia di esecuzione e i risultati di ogni istanza con trigger del processo pianificato su disco. Il valore di questo parametro determina il numero di risultati dell'istanza del processo salvato per il processo pianificato. Quando il numero di risultati dell'istanza del processo supera questo valore, Windows PowerShell elimina i risultati del processo meno recente per liberare spazio per i risultati dell'istanza del processo più recente.

La cronologia di esecuzione del processo e i risultati del processo vengono salvati in $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs\<JobName>\Output\<Timestamp> directory nel computer in cui viene creato il processo. Per visualizzare la cronologia di esecuzione, usare il Get-Job cmdlet . Per ottenere i risultati del processo, usare il Receive-Job cmdlet .

Il parametro MaxResultCount imposta il valore della proprietà ExecutionHistoryLength del processo pianificato.

Per eliminare la cronologia di esecuzione corrente e i risultati del processo, usare il parametro ClearExecutionHistory .

Specifica un nuovo nome per il processo pianificato e le istanze del processo pianificato. Il nome deve essere univoco nel computer locale.

Per identificare il processo pianificato da modificare, usare il parametro InputObject o inviare tramite pipe un processo pianificato da Get-ScheduledJob a Set-ScheduledJob.

Questo parametro non modifica i nomi delle istanze del processo su disco, ma solo le istanze di processo che vengono avviate dopo il completamento del comando.

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

Esegue il processo pianificato in un processo a 32 bit.

Consente di specificare la frequenza con cui eseguire il processo. Ad esempio, usare questa opzione per eseguire un processo ogni 15 minuti.

Avvia immediatamente un processo, non appena viene eseguito il Set-ScheduledJob cmdlet. Questo parametro evita di dover attivare Utilità di pianificazione per eseguire uno script di Windows PowerShell subito dopo la registrazione e non richiede agli utenti di creare un trigger che specifichi una data e un'ora di inizio.

Imposta le opzioni per il processo pianificato. Immettere un oggetto ScheduledJobOptions , ad esempio quello creato usando il New-ScheduledJobOption cmdlet o un valore di tabella hash.

È possibile impostare le opzioni per un processo pianificato quando si registra il processo pianificato oppure si usano i Set-ScheduledJobOption cmdlet o Set-ScheduledJob per impostare o modificare le opzioni.

Molte opzioni e i relativi valori predefiniti determinano se e quando viene eseguito un processo pianificato. Assicurarsi di esaminare queste opzioni prima di pianificare un processo. Per una descrizione delle opzioni di processo pianificate, inclusi i valori predefiniti, vedere New-ScheduledJobOption.

Per inviare una tabella hash, usare le chiavi seguenti. Nella seguente tabella hash, le chiavi vengono visualizzate con i relativi valori predefiniti.

@{# Power SettingsStartIfOnBattery=$False;StopIfGoingOnBattery=$True; WakeToRun=$False; # Idle SettingsStartIfNotIdle=$False; IdleDuration="00:10:00"; IdleTimeout="01:00:00"; StopIfGoingOffIdle=$True; RestartOnIdleResume=$False;# Security settingsShowInTaskScheduler=$TrueRunElevated=$False;# MiscRunWithoutNetwork=$False;DoNotAllowDemandStart=$False;MultipleInstancePolicy=IgnoreNew# Can be IgnoreNew, Parallel, Queue, StopExisting}

Specifica i comandi eseguiti dal processo pianificato. Racchiudere i comandi tra parentesi graffe ({}) per creare un blocco di script. Per specificare i valori predefiniti per i parametri di comando, usare il parametro ArgumentList .

Ogni Register-ScheduledJob comando deve usare i parametri ScriptBlock o FilePath .

Specifica i trigger per il processo pianificato. Immettere uno o più oggetti ScheduledJobTrigger , ad esempio gli oggetti restituiti dal New-JobTrigger cmdlet o una tabella hash di chiavi e valori del trigger di processo.

Un trigger di processo avvia automaticamente un processo pianificato in base a una pianificazione singola o ricorrente o quando si verifica un evento.

I trigger di processo sono facoltativi. È possibile aggiungere un trigger quando si crea il processo pianificato, usare i Add-JobTrigger cmdlet o Set-ScheduledJob per aggiungere trigger in un secondo momento oppure usare il Start-Job cmdlet per avviare immediatamente il processo pianificato. È anche possibile creare e mantenere un processo pianificato senza alcun trigger di processo.

Per inviare una tabella hash, usare le chiavi seguenti.

@{Frequency="Once" (or Daily, Weekly, AtStartup, AtLogon);At="3am" (o qualsiasi stringa temporale valida); DaysOfWeek="Monday", "Wednesday" (o qualsiasi combinazione di nomi dei giorni); Interval=2 (o qualsiasi intervallo di frequenza valido); RandomDelay="30minutes" (o qualsiasi stringa intervallo di tempo valida); User="Domain1\User01" (o qualsiasi utente valido; usato solo con il valore della frequenza AtLogon)

}