Crea un’istanza di compito pianificato.
Sintassi
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Descrizione
Il cmdlet New-ScheduledTask crea un oggetto che contiene la definizione di un compito pianificato.New-ScheduledTask non registra automaticamente l’oggetto con il servizio Task Scheduler.
È possibile registrare un’attività per eseguire uno dei seguenti tipi di applicazioni o file: Applicazioni Win32, applicazioni Win16, applicazioni OS/2, applicazioni MS-DOS, file batch (.bat), file di comando (.cmd), o qualsiasi tipo di file correttamente registrato.
Esempi
Esempio 1: Definire un’attività pianificata e registrarla in un secondo momento
PS C:\> $A = New-ScheduledTaskAction -Execute "Taskmgr.exe"PS C:\> $T = New-ScheduledTaskTrigger -AtLogonPS C:\> $P = New-ScheduledTaskPrincipal "Contoso\Administrator"PS C:\> $S = New-ScheduledTaskSettingsSetPS C:\> $D = New-ScheduledTask -Action $A -Principal $P -Trigger $T -Settings $SPS C:\> Register-ScheduledTask T1 -InputObject $DIn questo esempio, l’insieme dei comandi usa diversi cmdlets e variabili per definire e poi registrare un’attività pianificata.
Il primo comando usa il cmdlet New-ScheduledTaskAction per assegnare il file eseguibile tskmgr.exe alla variabile $A.
Il secondo comando usa il cmdlet New-ScheduledTaskTrigger per assegnare il valore AtLogon alla variabile $T.
Il terzo comando assegna il principale dell’attività pianificata Contoso\Administrator alla variabile $P.
Il quarto comando usa il cmdlet New-ScheduledTaskSettingsSet per assegnare un oggetto impostazioni attività alla variabile $S.
Il quinto comando crea una nuova attività e assegna la definizione dell’attività alla variabile $D.
Il sesto comando (ipoteticamente) viene eseguito in un secondo momento, registra la nuova attività pianificata e la definisce usando la variabile $D.
Parametri
Specifica un array di elementi di lavoro per un’attività da eseguire.
| Type: | CimInstance |
| Position: | 0 |
| Valore predefinito: | None |
| Accetta ingresso pipeline: | False |
| Accetta caratteri jolly: | False |
Esegue il cmdlet come un lavoro in background. Usa questo parametro per eseguire comandi che richiedono molto tempo per essere completati.
| Type: | SwitchParameter |
| Position: | Named |
| Valore predefinito: | None |
| Accetta l’input della pipeline: | Falso |
| Accetta caratteri jolly: | Falso |
Esegue il cmdlet in una sessione remota o su un computer remoto.Inserisci un nome di computer o un oggetto di sessione, come l’output di un cmdlet New-CimSession o Get-CimSession.L’impostazione predefinita è la sessione corrente sul computer locale.
| Type: | CimSession |
| Alias: | Session |
| Position: | Named |
| Valore predefinito: | Nessuno |
| Accetta input pipeline: | Falso |
| Accetta caratteri jolly: | Falso |
Descrizione breve del compito.
| Tipo: | Stringa |
| Posizione: | 4 |
| Valore predefinito: | Nessuno |
| Accetta ingresso pipeline: | Falso |
| Accetta caratteri jolly: | Falso |
Specifica il contesto di sicurezza in cui viene eseguito il task.
| Type: | CimInstance |
| Position: | 3 |
| Valore predefinito: | None |
| Accetta ingresso pipeline: | False |
| Accetta caratteri jolly: | False |
Specifica un oggetto di configurazione che il servizio Task Scheduler usa per determinare come eseguire un task.
| Type: | CimInstance |
| Position: | 2 |
| Valore predefinito: | None |
| Accetta ingresso pipeline: | Falso |
| Accetta caratteri jolly: | Falso |
Specifica il numero massimo di operazioni concorrenti che possono essere stabilite per eseguire la cmdlet.Se questo parametro viene omesso o viene inserito un valore di 0, allora Windows PowerShell® calcola un limite di accelerazione ottimale per la cmdlet in base al numero di cmdlet CIM che sono in esecuzione sul computer.Il limite di accelerazione si applica solo al cmdlet corrente, non alla sessione o al computer.
| Type: | Int32 |
| Position: | Named |
| Valore predefinito: | None |
| Accetta ingresso pipeline: | Falso |
| Accetta caratteri jolly: | Falso |
Specifica un array di uno o più oggetti trigger che causano l’avvio di un task pianificato.
Un trigger è un insieme di criteri che avvia un’attività pianificata quando i criteri sono soddisfatti.Puoi usare un trigger basato sul tempo o un trigger basato sull’evento per avviare un’attività, e uno o più trigger possono avviare un’attività.Un’attività può avere fino a 48 trigger.Per maggiori informazioni sui trigger, vedi Trigger.
| Type: | CimInstance |
| Position: | 1 |
| Valore predefinito: | Nessuno |
| Accetta input pipeline: | Falso |
| Accetta caratteri jolly: | False |
Outputs
CimInstance
- Disable-ScheduledTask
- Enable-ScheduledTask
- Export-ScheduledTask
- Get-ScheduledTask
- New-ScheduledTaskAction
- New-ScheduledTaskSettingsSet
- New-ScheduledTaskPrincipal
- New-ScheduledTaskTrigger
- Register-ScheduledTask
- Set-ScheduledTask
- Start-ScheduledTask
- Stop-ScheduledTask
- Unregister-ScheduledTask