Maakt een scheduled task instance.
Syntax
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Description
Het cmdlet New-ScheduledTask maakt een object aan dat de definitie van een scheduled task bevat.New-ScheduledTask registreert het object niet automatisch bij de service Task Scheduler.
U kunt een taak registreren om een van de volgende toepassings- of bestandstypen uit te voeren: Win32-toepassingen, Win16-toepassingen, OS/2-toepassingen, MS-DOS-toepassingen, batchbestanden (.bat), opdrachtbestanden (.cmd), of elk correct geregistreerd bestandstype.
Voorbeelden
Voorbeeld 1: Een geplande taak definiëren en deze later registreren
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 dit voorbeeld gebruikt de set opdrachten verschillende cmdlets en variabelen om een geplande taak te definiëren en vervolgens te registreren.
Het eerste commando gebruikt het cmdlet New-ScheduledTaskAction om het uitvoerbare bestand tskmgr.exe toe te wijzen aan de variabele $A.
Het tweede commando gebruikt het cmdlet New-ScheduledTaskTrigger om de waarde AtLogon toe te wijzen aan de variabele $T.
Het derde commando wijst de opdrachtgever van de geplande taak Contoso\Administrator toe aan de variabele $P.
Het vierde commando gebruikt het cmdlet New-ScheduledTaskSettingsSet om een object voor taakinstellingen toe te wijzen aan de variabele $S.
Het vijfde commando creëert een nieuwe taak en wijst de taakdefinitie toe aan de variabele $D.
Het zesde commando (hypothetisch) wordt op een later tijdstip uitgevoerd.Het registreert de nieuwe geplande taak en definieert deze met behulp van de variabele $D.
Parameters
Specificeert een array van werkitems voor een taak om uit te voeren.Wanneer u meerdere acties specificeert, worden ze sequentieel uitgevoerd.Een taak kan maximaal 32 acties hebben.
| Type: | CimInstance |
| Positie: | 0 |
| Standaardwaarde: | None |
| Accepteer pijplijninvoer: | False |
| Accept wildcard characters: | False |
Draait het cmdlet als een achtergrondjob. Gebruik deze parameter om commando’s uit te voeren die een lange tijd nodig hebben om te voltooien.
| Type: | SwitchParameter |
| Positie: | Naam |
| Voorkeurwaarde: | None |
| Accepteer pijplijninvoer: | False |
| Accept wildcard characters: | False |
Uitvoeren van het cmdlet in een remote sessie of op een remote computer.Voer een computernaam in of een sessie object, zoals de uitvoer van een New-CimSession of Get-CimSession cmdlet.De standaardwaarde is de huidige sessie op de lokale computer.
| Type: | CimSession |
| Aliassen: | Session |
| Position: | Name |
| Afwijkende waarde: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Brieft een beschrijving van de taak.
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specificeert de beveiligingscontext waarin een taak wordt uitgevoerd.
| Type: | CimInstance |
| Positie: | 3 |
| Standaardwaarde: | None |
| Accepteer pijplijninvoer: | False |
| Accept wildcard characters: | False |
Specificeert een configuratie-object dat de Task Scheduler-service gebruikt om te bepalen hoe een taak moet worden uitgevoerd.
| Type: | CimInstance |
| Positie: | 2 |
| Standaardwaarde: | None |
| Accepteer invoer via pijplijn: | False |
| Accept wildcard characters: | False |
Specificeert het maximum aantal gelijktijdige bewerkingen dat kan worden ingesteld om het cmdlet uit te voeren.Als deze parameter wordt weggelaten of een waarde van 0 wordt ingevoerd, berekent Windows PowerShell® een optimale throttle-limiet voor het cmdlet op basis van het aantal CIM cmdlets dat op de computer wordt uitgevoerd.De throttle limit is alleen van toepassing op het huidige cmdlet, niet op de sessie of op de computer.
| Type: | Int32 |
| Positie: | Naam |
| Standaardwaarde: | None |
| Accepteer invoer via pijplijn: | False |
| Accept wildcard characters: | False |
Specificeert een array van een of meer trigger-objecten die een geplande taak doen starten.
Een trigger is een set criteria die een geplande taak start wanneer aan de criteria wordt voldaan.U kunt een tijdgebaseerde trigger of een gebeurtenisgebaseerde trigger gebruiken om een taak te starten, en een of meer triggers kunnen een taak starten.Een taak kan maximaal 48 triggers hebben.Voor meer informatie over triggers, zie Triggers.
| Type: | CimInstance |
| Position: | 1 |
| Aanwezige waarde: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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