Tworzy instancję zaplanowanego zadania.
Syntax
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Description
Ccmdlet New-ScheduledTask tworzy obiekt zawierający definicję zaplanowanego zadania.New-ScheduledTask nie rejestruje automatycznie obiektu w usłudze Task Scheduler.
Można zarejestrować zadanie w celu uruchomienia dowolnego z następujących typów aplikacji lub plików: Aplikacje Win32, aplikacje Win16, aplikacje OS/2, aplikacje MS-DOS, pliki wsadowe (.bat), pliki poleceń (.cmd) lub dowolny poprawnie zarejestrowany typ pliku.
Przykłady
Przykład 1: Definiowanie zaplanowanego zadania i rejestrowanie go w późniejszym czasie
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 $DW tym przykładzie zestaw poleceń wykorzystuje kilka cmdletów i zmiennych do zdefiniowania, a następnie zarejestrowania zaplanowanego zadania.
Pierwsze polecenie wykorzystuje cmdlet New-ScheduledTaskAction do przypisania pliku wykonywalnego tskmgr.exe do zmiennej $A.
Drugie polecenie wykorzystuje cmdlet New-ScheduledTaskTrigger do przypisania wartości AtLogon do zmiennej $T.
Trzecie polecenie przypisuje zleceniodawcę zaplanowanego zadania Contoso\Administrator do zmiennej $P.
Czwarte polecenie wykorzystuje cmdlet New-ScheduledTaskSettingsSet do przypisania obiektu ustawień zadania do zmiennej $S.
Piąte polecenie tworzy nowe zadanie i przypisuje definicję zadania do zmiennej $D.
Szóste polecenie (hipotetycznie) uruchamia się w późniejszym czasie.Rejestruje nowe zaplanowane zadanie i definiuje je za pomocą zmiennej $D.
Parametry
Określa tablicę elementów roboczych dla zadania do uruchomienia.W przypadku określenia wielu akcji są one uruchamiane sekwencyjnie.Zadanie może mieć do 32 akcji.
| Typ: | CimInstance |
| Position: | 0 |
| Wartość domyślna: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Uruchamia cmdlet jako zadanie w tle. Użyj tego parametru do uruchamiania poleceń, których wykonanie zajmuje dużo czasu.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Uruchamia cmdlet w zdalnej sesji lub na zdalnym komputerze.Wprowadź nazwę komputera lub obiekt sesji, taki jak dane wyjściowe polecenia New-CimSession lub Get-CimSession.Domyślnie jest to bieżąca sesja na komputerze lokalnym.
| Typ: | CimSession |
| Alias: | Session |
| Position: | Named |
| Wartość domyślna: | Nie |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Zwięźle opisuje zadanie.
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Określa kontekst zabezpieczeń, w którym działa zadanie.
| Type: | CimInstance |
| Position: | 3 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Określa obiekt konfiguracyjny, którego usługa Harmonogram zadań używa do określenia sposobu uruchamiania zadania.
| Type: | CimInstance |
| Position: | 2 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Określa maksymalną liczbę współbieżnych operacji, które można ustanowić w celu uruchomienia cmdleta.Jeśli ten parametr zostanie pominięty lub wprowadzona zostanie wartość 0, wówczas program Windows PowerShell® oblicza optymalny limit przepustnicy dla cmdleta na podstawie liczby cmdletów CIM uruchomionych na komputerze.Limit dławienia dotyczy tylko bieżącego polecenia cmdlet, nie dotyczy sesji ani komputera.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Podaje tablicę jednego lub więcej obiektów wyzwalaczy, które powodują uruchomienie zaplanowanego zadania.
Wyzwalacz to zestaw kryteriów, który uruchamia zaplanowane zadanie, gdy kryteria są spełnione.Do uruchomienia zadania można użyć wyzwalacza czasowego lub wyzwalacza opartego na zdarzeniu, a jedno lub więcej wyzwalaczy może uruchomić zadanie.Zadanie może mieć do 48 wyzwalaczy.Aby uzyskać więcej informacji na temat wyzwalaczy, zobacz Wyzwalacze.
| Typ: | CimInstance |
| Position: | 1 |
| Wartość domyślna: | 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
- Unregister-ScheduledTask
.