Erstellt eine geplante Aufgabeninstanz.
Syntax
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Beschreibung
Das Cmdlet New-ScheduledTask erstellt ein Objekt, das die Definition einer geplanten Aufgabe enthält.New-ScheduledTask registriert das Objekt nicht automatisch beim Taskplanerdienst.
Sie können eine Aufgabe registrieren, um eine der folgenden Anwendungen oder Dateitypen auszuführen: Win32-Anwendungen, Win16-Anwendungen, OS/2-Anwendungen, MS-DOS-Anwendungen, Batch-Dateien (.bat), Befehlsdateien (.cmd) oder jeder ordnungsgemäß registrierte Dateityp.
Beispiele
Beispiel 1: Eine geplante Aufgabe definieren und zu einem späteren Zeitpunkt registrieren
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 diesem Beispiel verwendet der Befehlssatz mehrere Cmdlets und Variablen, um eine geplante Aufgabe zu definieren und dann zu registrieren.
Der erste Befehl verwendet das Cmdlet „New-ScheduledTaskAction“, um der Variablen $A die ausführbare Datei tskmgr.exe zuzuweisen.
Der zweite Befehl verwendet das Cmdlet „New-ScheduledTaskTrigger“, um der Variablen $T den Wert AtLogon zuzuweisen.
Der dritte Befehl weist den Auftraggeber der geplanten Aufgabe Contoso\Administrator der Variablen $P zu.
Der vierte Befehl verwendet das Cmdlet „New-ScheduledTaskSettingsSet“, um der Variablen $S ein Aufgabeneinstellungsobjekt zuzuweisen.
Der fünfte Befehl erstellt eine neue Aufgabe und weist die Aufgabendefinition der Variablen $D zu.
Der sechste Befehl wird (hypothetisch) zu einem späteren Zeitpunkt ausgeführt.
Parameter
Spezifiziert ein Array von Arbeitselementen für eine auszuführende Aufgabe.
Wenn Sie mehrere Aktionen angeben, werden diese nacheinander ausgeführt.
Eine Aufgabe kann bis zu 32 Aktionen haben.
| Typ: | CimInstance |
| Position: | 0 |
| Standardwert: | Keine |
| Akzeptiere Pipelineeingabe: | False |
| Accept wildcard characters: | False |
Führt das Cmdlet als Hintergrundauftrag aus. Verwenden Sie diesen Parameter, um Befehle auszuführen, deren Ausführung viel Zeit in Anspruch nimmt.
| Typ: | SwitchParameter |
| Position: | Benannt |
| Standardwert: | Keine |
| Akzeptiere Pipelineeingabe: | False |
| Accept wildcard characters: | False |
Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus.Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets „New-CimSession“ oder „Get-CimSession“.Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.
| Typ: | CimSession |
| Aliases: | Session |
| Position: | Name |
| Standardwert: | Keine |
| Akzeptiere Pipeline-Eingabe: | False |
| Akzeptiere Platzhalterzeichen: | False |
Beschreibt die Aufgabe kurz.
| Typ: | String |
| Position: | 4 |
| Standardwert: | Keine |
| Akzeptiere Pipelineeingabe: | False |
| Accept wildcard characters: | False |
Spezifiziert den Sicherheitskontext, in dem eine Aufgabe läuft.
| Typ: | CimInstance |
| Position: | 3 |
| Standardwert: | Keine |
| Akzeptiere Pipelineeingabe: | False |
| Accept wildcard characters: | False |
Spezifiziert ein Konfigurationsobjekt, das der Taskplaner-Dienst verwendet, um zu bestimmen, wie eine Aufgabe ausgeführt wird.
| Typ: | CimInstance |
| Position: | 2 |
| Standardwert: | Keine |
| Akzeptiere Pipelineeingabe: | False |
| Accept wildcard characters: | False |
Bestimmt die maximale Anzahl gleichzeitiger Vorgänge, die für die Ausführung des Cmdlets eingerichtet werden können.Wenn dieser Parameter weggelassen oder ein Wert von 0 eingegeben wird, berechnet Windows PowerShell® ein optimales Drosselungslimit für das Cmdlet auf der Grundlage der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden.Das Drosselungslimit gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder den Computer.
| Typ: | Int32 |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipelineeingabe akzeptieren: | False |
| Accept wildcard characters: | False |
Spezifiziert ein Array von einem oder mehreren Trigger-Objekten, die den Start einer geplanten Aufgabe verursachen.
Ein Auslöser ist ein Satz von Kriterien, der eine geplante Aufgabe startet, wenn die Kriterien erfüllt sind.Sie können einen zeitbasierten Auslöser oder einen ereignisbasierten Auslöser verwenden, um eine Aufgabe zu starten, und ein oder mehrere Auslöser können eine Aufgabe starten.Eine Aufgabe kann bis zu 48 Auslöser haben.Weitere Informationen über Auslöser finden Sie unter Auslöser.
| Typ: | CimInstance |
| Position: | 1 |
| Standardwert: | Keine |
| 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