Skapa en instans av schemalagd aktivitet.
Syntax
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Beskrivning
Cmdletten New-ScheduledTask skapar ett objekt som innehåller definitionen av en schemalagd aktivitet.New-ScheduledTask registrerar inte automatiskt objektet i tjänsten Task Scheduler.
Du kan registrera en aktivitet för att köra någon av följande program- eller filtyper: Win32-program, Win16-program, OS/2-program, MS-DOS-program, batchfiler (.bat), kommandofiler (.cmd) eller andra korrekt registrerade filtyper.
Exempel
Exempel 1: Definiera en schemalagd aktivitet och registrera den senare
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 $DI det här exemplet används flera cmdlets och variabler för att definiera och sedan registrera en schemalagd aktivitet.
Det första kommandot använder cmdlet New-ScheduledTaskAction för att tilldela den körbara filen tskmgr.exe till variabeln $A.
Det andra kommandot använder cmdlet New-ScheduledTaskTrigger för att tilldela värdet AtLogon till variabeln $T.
Det tredje kommandot tilldelar huvudmannen för den schemalagda uppgiften Contoso\Administrator till variabeln $P.
Det fjärde kommandot använder cmdlet New-ScheduledTaskSettingsSet för att tilldela ett objekt för uppgiftsinställningar till variabeln $S.
Det femte kommandot skapar en ny uppgift och tilldelar uppgiftsdefinitionen till variabeln $D.
Det sjätte kommandot körs (hypotetiskt) vid en senare tidpunkt. det registrerar den nya schemalagda aktiviteten och definierar den med hjälp av variabeln $D.
Parameters
Anger en matris med arbetsobjekt för att en aktivitet ska kunna köras. när du anger flera åtgärder körs de sekventiellt. en aktivitet kan ha upp till 32 åtgärder.
| Typ: | CimInstance |
| Position: | 0 |
| Standardvärde: | Ingen |
| Acceptera inmatning från pipeline: | False |
| Accept wildcard characters: | False |
Kör cmdlet som ett bakgrundsjobb. Använd den här parametern för att köra kommandon som tar lång tid att slutföra.
| Typ: | SwitchParameter |
| Position: | Namn |
| Standardvärde: | Ingen |
| Accepterar inmatning från pipeline: | False |
| Accept wildcard characters: | False |
Kör cmdlet i en fjärrsession eller på en fjärrdator.Ange ett datornamn eller ett sessionsobjekt, t.ex. resultatet från cmdlet New-CimSession eller Get-CimSession.Standardvärdet är den aktuella sessionen på den lokala datorn.
| Typ: | CimSession |
| Alias: | Session |
| Position: | Named |
| Standardvärde: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Brytfattat beskriver uppgiften.
| Typ: | String |
| Position: | 4 |
| Standardvärde: | Ingen |
| Acceptera inmatning från rörledningen: | False |
| Accept wildcard characters: | False |
Specificerar säkerhetskontexten i vilken en aktivitet körs.
| Typ: | CimInstance |
| Position: | 3 |
| Standardvärde: | Inne |
| Acceptera inmatning från pipeline: | False |
| Accept wildcard characters: | False |
Anger ett konfigurationsobjekt som tjänsten Task Scheduler använder för att bestämma hur en aktivitet ska köras.
| Typ: | CimInstance |
| Position: | 2 |
| Standardvärde: | Ingen |
| Acceptera inmatning från pipeline: | False |
| Accept wildcard characters: | False |
Anger det maximala antalet samtidiga operationer som kan upprättas för att köra cmdlet.Om den här parametern utelämnas eller om ett värde på 0 anges beräknar Windows PowerShell® en optimal strypningsgräns för cmdlet baserat på antalet CIM-cmdlets som körs på datorn.Gasningsgränsen gäller endast för den aktuella cmdlet, inte för sessionen eller datorn.
| Typ: | Int32 |
| Position: | Namn |
| Standardvärde: | Inte |
| Acceptera inmatning från pipeline: | False |
| Accept wildcard characters: | False |
Anger en matris med ett eller flera utlösningsobjekt som gör att en schemalagd aktivitet startas.
En utlösare är en uppsättning kriterier som startar en schemalagd aktivitet när kriterierna är uppfyllda.Du kan använda en tidsbaserad utlösare eller en händelsebaserad utlösare för att starta en aktivitet, och en eller flera utlösare kan starta en aktivitet.En aktivitet kan ha upp till 48 utlösare.Mer information om utlösare finns i Utlösare.
| Typ: | CimInstance |
| Position: | 1 |
| Standardvärde: | 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
- Unregistrer-ScheduledTask