Opret en instans af en planlagt opgave.
Syntaks
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >]
Beskrivelse
Cmdletten New-ScheduledTask opretter et objekt, der indeholder definitionen af en planlagt opgave.New-ScheduledTask registrerer ikke automatisk objektet med tjenesten Opgavestyring.
Du kan registrere en opgave til at køre et af følgende programmer eller filtyper: Win32-programmer, Win16-programmer, OS/2-programmer, MS-DOS-programmer, batchfiler (.bat), kommandofiler (.cmd) eller enhver korrekt registreret filtype.
Eksempler
Eksempel 1: Definer en planlagt opgave og registrer den på et senere tidspunkt
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 $D
I dette eksempel bruger kommandoerne flere cmdlets og variabler til at definere og derefter registrere en planlagt opgave.
Den første kommando bruger cmdletten New-ScheduledTaskAction til at tildele den eksekverbare fil tskmgr.exe til variablen $A.
Den anden kommando bruger cmdletten New-ScheduledTaskTrigger til at tildele værdien AtLogon til variablen $T.
Den tredje kommando tildeler hovedpersonen for den planlagte opgave Contoso\Administrator
til variablen $P.
Den fjerde kommando bruger cmdletten New-ScheduledTaskSettingsSet til at tildele et objekt for opgaveindstillinger til variablen $S.
Den femte kommando opretter en ny opgave og tildeler opgavedeklarationen til variablen $D.
Den sjette kommando kører (hypotetisk) på et senere tidspunkt. den registrerer den nye planlagte opgave og definerer den ved hjælp af variablen $D.
Parameters
Angiver et array af arbejdsemner, som en opgave skal køre. når du angiver flere handlinger, kører de i rækkefølge. en opgave kan have op til 32 handlinger.
Type: | CimInstance | |
Position: | 0 | |
Standardværdi: | None | |
Accept pipeline input: | False | |
Accepter jokertegn: | False |
Kører cmdletten som et baggrundsjob. Brug denne parameter til at køre kommandoer, der tager lang tid at udføre.
Type: | SwitchParameter |
Position: | Named |
Defaultværdi: | None |
Accept pipeline input: | False |
Accepter jokertegn: | False |
Afvikler cmdletten i en fjernsession eller på en fjerncomputer.Indtast et computernavn eller et sessionsobjekt, f.eks. output fra en cmdlet New-CimSession eller Get-CimSession.Standardindstillingen er den aktuelle session på den lokale computer.
Type: | CimSession | |
Aliases: | Session | |
Position: | Named | |
Standardværdi: | Ingen | |
Accepter input fra pipeline: | Falsk | |
Accepter jokertegn: | Falsk |
Beskriv kortfattet opgaven.
Type: | String | |
Position: | 4 | |
Standardværdi: | None | |
Accept pipeline input: | False | |
Accepter jokertegn: | False |
Angiver den sikkerhedskontekst, som en opgave kører i.
Type: | CimInstance | |
Position: | 3 | |
Standardværdi: | None | |
Accept pipeline input: | Falsk | |
Accepter jokertegn: | Falsk |
Angiver et konfigurationsobjekt, som tjenesten Opgavestyringstjenesten bruger til at bestemme, hvordan en opgave skal køres.
Type: | CimInstance |
Position: | 2 |
Defaultværdi: | None |
Accept pipeline input: | False |
Accepter jokertegn: | False |
Angiver det maksimale antal samtidige operationer, der kan etableres for at køre cmdlet’en.Hvis denne parameter udelades, eller hvis der angives en værdi på 0
, beregner Windows PowerShell® en optimal throttle-grænse for cmdletten baseret på antallet af CIM-cmdlets, der kører på computeren.Begrænsningsgrænsen gælder kun for den aktuelle cmdlet og ikke for sessionen eller computeren.
Type: | Int32 |
Position: | Named |
Defaultværdi: | None |
Accept pipeline input: | Falsk |
Accepter jokertegn: | Falsk |
Angiver et array af et eller flere triggerobjekter, der får en planlagt opgave til at starte.
En udløser er et sæt kriterier, der starter en planlagt opgave, når kriterierne er opfyldt.Du kan bruge en tidsbaseret udløser eller en hændelsesbaseret udløser til at starte en opgave, og en eller flere udløsere kan starte en opgave.En opgave kan have op til 48 udløsere.Du kan finde flere oplysninger om udløsere under Udløsere.
Type: | CimInstance | |
Position: | 1 | |
Standardværdi: | None | |
Accept pipeline input: | False | |
Accept wildcard-tegn: | Falsk |
Output
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