Syntaxe
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Popis
Komenda New-ScheduledTask vytvoří objekt, který obsahuje definici naplánované úlohy.Příkaz New-ScheduledTask automaticky neregistruje objekt ve službě Plánovač úloh.
Úlohu můžete zaregistrovat pro spuštění některé z následujících aplikací nebo typů souborů: Aplikace Win32, aplikace Win16, aplikace OS/2, aplikace MS-DOS, dávkové soubory (.bat), příkazové soubory (.cmd) nebo jakýkoli správně zaregistrovaný typ souboru.
Příklady
Příklad 1: V tomto příkladu sada příkazů používá několik rutin a proměnných k definování a následné registraci naplánované úlohy
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.
První příkaz používá rutinu New-ScheduledTaskAction k přiřazení spustitelného souboru tskmgr.exe do proměnné $A.
Druhý příkaz používá rutinu New-ScheduledTaskTrigger k přiřazení hodnoty AtLogon do proměnné $T.
Třetí příkaz přiřadí zadavatele naplánované úlohy Contoso\Administrator do proměnné $P.
Čtvrtý příkaz použije rutinu New-ScheduledTaskSettingsSet k přiřazení objektu nastavení úlohy do proměnné $S.
Pátý příkaz vytvoří novou úlohu a přiřadí definici úlohy do proměnné $D.
Šestý příkaz se (hypoteticky) spustí později. zaregistruje novou naplánovanou úlohu a definuje ji pomocí proměnné $D.
Parametry
Určí pole pracovních položek pro spuštění úlohy. pokud zadáte více akcí, spustí se postupně. úloha může mít až 32 akcí.
| Typ: | CimInstance |
| Pozice: | 0 |
| Výchozí hodnota: | None |
| Přijímá vstup do potrubí: | False |
| Accept wildcard characters: | False |
Spustí rutinu jako úlohu na pozadí. Tento parametr použijte ke spuštění příkazů, jejichž dokončení trvá dlouho.
| Typ: | PřepínačParametr |
| Pozice: | Název |
| Výchozí hodnota: | Jedna |
| Přijímá vstup do potrubí: | False |
| Accept wildcard characters: | False |
Spustí rutinu ve vzdálené relaci nebo na vzdáleném počítači.Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSession.Výchozí je aktuální relace v místním počítači.
| Typ: | CimSession |
| Aliasy: | Session |
| Pozice: | Název |
| Výchozí hodnota: | Nulová |
| Přijímá vstup z potrubí: | Ne |
| Přijímá zástupné znaky: | Ne |
Krátce popisuje úlohu.
| Typ: | Řetězec |
| Pozice: | 4 |
| Výchozí hodnota: | Nic |
| Přijímá vstup do potrubí: | False |
| Accept wildcard characters: | False |
Určuje bezpečnostní kontext, ve kterém úloha běží.
| Typ: | CimInstance |
| Pozice: | 3 |
| Výchozí hodnota: | None |
| Přijímá vstup do potrubí: | False |
| Accept wildcard characters: | False |
Určuje konfigurační objekt, který služba plánovače úloh používá k určení způsobu spuštění úlohy.
| Typ: | CimInstance |
| Pozice: | 2 |
| Výchozí hodnota: | None |
| Přijímá vstup do potrubí: | False |
| Accept wildcard characters: | False |
Určuje maximální počet souběžných operací, které lze vytvořit pro spuštění rutiny.Pokud je tento parametr vynechán nebo je zadána hodnota 0, pak prostředí Windows PowerShell® vypočítá optimální throttle limit pro rutinu na základě počtu rutin CIM spuštěných v počítači.Limit škrcení se vztahuje pouze na aktuální rutinu, nikoli na relaci nebo počítač.
| Typ: | Int32 |
| Pozice: | Název |
| Výchozí hodnota: | None |
| Přijmout vstup do potrubí: | False |
| Accept wildcard characters: | False |
Určuje pole jednoho nebo více spouštěcích objektů, které způsobí spuštění naplánované úlohy.
Spouštěč je sada kritérií, která spustí naplánovanou úlohu, když jsou kritéria splněna. ke spuštění úlohy můžete použít spouštěč založený na čase nebo spouštěč založený na události, přičemž úlohu může spustit jeden nebo více spouštěčů. jedna úloha může mít až 48 spouštěčů. další informace o spouštěčích najdete v části Spouštěče.
| Typ: | CimInstance |
| Pozice: | 1 |
| Výchozí hodnota: | Nulová |
| Přijímání vstupů z potrubí: | False |
| Přijímání zástupných znaků: | False |
Výstupy
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