Creează o instanță de sarcină programată.
Sintaxa
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >]
Descriere
Codleta New-ScheduledTask creează un obiect care conține definiția unei sarcini programate.New-ScheduledTask nu înregistrează automat obiectul cu serviciul Task Scheduler.
Puteți înregistra o sarcină pentru a executa oricare dintre următoarele tipuri de aplicații sau fișiere: aplicații Win32, aplicații Win16, aplicații OS/2, aplicații MS-DOS, fișiere batch (.bat), fișiere de comandă (.cmd) sau orice tip de fișier înregistrat corespunzător.
Exemple
Exemplu 1: Definirea unei sarcini programate și înregistrarea ulterioară a acesteia
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
În acest exemplu, setul de comenzi utilizează mai multe cmdlet-uri și variabile pentru a defini și apoi a înregistra o sarcină programată.
Prima comandă utilizează cmdlet-ul New-ScheduledTaskAction pentru a atribui fișierul executabil tskmgr.exe la variabila $A.
A doua comandă utilizează cmdlet-ul New-ScheduledTaskTrigger pentru a atribui valoarea AtLogon la variabila $T.
Cea de-a treia comandă atribuie principalul sarcinii programate Contoso\Administrator
variabilei $P.
Cea de-a patra comandă utilizează cmdlet-ul New-ScheduledTaskSettingsSet pentru a atribui un obiect de setări ale sarcinii la variabila $S.
Cea de-a cincea comandă creează o nouă sarcină și atribuie definiția sarcinii la variabila $D.
.
Cea de-a șasea comandă (ipotetic) se execută la un moment ulterior.Aceasta înregistrează noua sarcină programată și o definește utilizând variabila $D.
Parametri
Specifică o matrice de elemente de lucru pentru ca o sarcină să se execute.Când specificați mai multe acțiuni, acestea se execută secvențial.O sarcină poate avea până la 32 de acțiuni.
Tip: | CimInstance |
Position: | 0 |
Valoare implicită: | None |
Acceptă intrarea în conductă: | False |
Acceptă caractere wildcard: | False |
Execută cmdlet-ul ca un job de fundal. Utilizați acest parametru pentru a rula comenzi care necesită mult timp pentru a fi finalizate.
Tip: | SwitchParameter |
Position: | Numit |
Valoare implicită: | None |
Acceptă intrarea în conductă: | False |
Acceptă caractere wildcard: | False |
Execută cmdlet-ul într-o sesiune la distanță sau pe un computer la distanță.Introduceți un nume de computer sau un obiect de sesiune, cum ar fi rezultatul unui cmdlet New-CimSession sau Get-CimSession.Valoarea implicită este sesiunea curentă de pe calculatorul local.
Type: | CimSession |
Aliases: | Session |
Position: | Named |
Valoare implicită: | Session |
Default value: | Nimic |
Acceptă intrări de tip pipeline: | False |
Acceptă caractere wildcard: | False |
Descrie pe scurt sarcina.
Tip: | Stringere |
Poziție: | 4 |
Valoare implicită: | Nimic |
Acceptă intrarea în conductă: | False |
Acceptă caractere wildcard: | False |
Specifică contextul de securitate în care se execută o sarcină.
Tip: | CimInstance |
Poziție: | 3 |
Valoare implicită: | Nimic |
Acceptă intrarea în conductă: | False |
Acceptă caractere wildcard: | False |
Specifică un obiect de configurare pe care serviciul Task Scheduler îl utilizează pentru a determina modul de executare a unei sarcini.
Tip: | CimInstance |
Poziție: | 2 |
Valoare implicită: | None |
Acceptă intrarea în conductă: | False |
Acceptă caractere wildcard: | False |
Specifică numărul maxim de operații simultane care pot fi stabilite pentru a rula cmdlet-ul.Dacă acest parametru este omis sau dacă se introduce o valoare de 0
, Windows PowerShell® calculează o limită optimă de limitare a accelerației pentru cmdlet pe baza numărului de cmdlet-uri CIM care rulează pe computer.Limita de strangulare se aplică numai cmdletului curent, nu și sesiunii sau calculatorului.
Type: | Int32 |
Position: | Named |
Valoare implicită: | None |
Accept pipeline input: | False |
Acceptă caractere wildcard: | False |
Specifică o matrice de unul sau mai multe obiecte de declanșare care determină pornirea unei sarcini programate.
Un declanșator este un set de criterii care pornește o sarcină programată atunci când criteriile sunt îndeplinite.Puteți utiliza un declanșator bazat pe timp sau un declanșator bazat pe eveniment pentru a porni o sarcină, iar unul sau mai multe declanșatoare pot porni o sarcină.O sarcină poate avea până la 48 de declanșatoare.Pentru mai multe informații despre declanșatoare, consultați Declanșatoare.
Type: | CimInstance | |
Position: | 1 | |
Default value: | None | |
Acceptă intrări de tip pipeline: | False | |
Acceptă caractere wildcard: | False |
Outputs
CimInstance
- Disable-ScheduledTask
- Enable-ScheduledTask
- Export-ScheduledTask
- Get-ScheduledTask
- New-ScheduledTaskAction
- New-ScheduledTaskSettingsSettingsSet
- New-ScheduledTaskPrincipal
- New-ScheduledTaskTrigger
- Register-ScheduledTask
- Set-Sheet-ScheduledTask
- Set-ScheduledTask
- Start-ScheduledTask
- Stop-ScheduledTask
- Unregister-ScheduledTask