Unregister-ScheduledJob

  • Odwołanie
Moduł:
PSScheduledJob

Usuwa zaplanowane zadania na komputerze lokalnym.

Składnia

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Opis

Polecenie Unregister-ScheduledJob cmdlet usuwa zaplanowane zadania z komputera lokalnego.

Gdy usuwa lub wyrejestrowuje zaplanowane zadanie, Unregister-ScheduledJob usuwa katalog zaplanowanego zadania (w pliku $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory), który zawiera plik XML, który definiuje zaplanowane zadanie, historię wykonywania zadania i wszystkie wyniki zadania. Ta akcja powoduje również usunięcie zadania z harmonogramu zadań.

Unregister-ScheduledJob Usuwa tylko zaplanowane zadania, które są tworzone przy użyciu Register-ScheduledJob polecenia cmdlet . Nie usuwa zaplanowanych zadań utworzonych w harmonogramie zadań.

Możesz użyć parametrów , Unregister-ScheduledJob aby usunąć zaplanowane zadania według identyfikatora lub nazwy lub potoku zaplanowanych zadań z Get-ScheduledJob do Unregister-ScheduledJob.

Unregister-ScheduledJob jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który znajduje się w programie Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w programie Windows PowerShell 3.0.

Przykłady

Przykład 1. Usuwanie zaplanowanego zadania

Unregister-ScheduledJob TestJob

To polecenie usuwa zaplanowane zadanie TestJob na komputerze lokalnym.

Przykład 2. Usuwanie wszystkich zaplanowanych zadań

Get-ScheduledJob | Unregister-ScheduledJob -Force
Unregister-ScheduledJob -Name "*" -Force

W tym przykładzie przedstawiono dwa różne polecenia, które usuwają wszystkie zaplanowane zadania na komputerze lokalnym.

Pierwsze polecenie używa Get-ScheduledJob polecenia cmdlet , aby pobrać wszystkie zaplanowane zadania na komputerze lokalnym. Operator potoku (|) wysyła zaplanowane zadania do Unregister-ScheduleJob, co powoduje ich usunięcie.

Drugie polecenie używa parametru Unregister-ScheduledJob Name z wartością wszystkich (*), aby usunąć wszystkie zaplanowane zadania.

Oba polecenia używają parametru Force , który usuwa zaplanowane zadanie, nawet jeśli wystąpienie zadania jest uruchomione.

Przykład 3. Usuwanie zaplanowanego zadania na komputerze zdalnym

Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

To polecenie usuwa zaplanowane zadania z nazwami rozpoczynającymi się od Test na komputerze zdalnym Server01. Polecenie używa Invoke-Command polecenia cmdlet do uruchomienia Unregister-ScheduledJob polecenia na komputerze Server02.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Usuwa zaplanowane zadanie nawet wtedy, gdy jest uruchomione wystąpienie zadania. Domyślnie Unregister-ScheduledJob nie przerywa uruchamiania zadań.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Usuwa zaplanowane zadania z określonymi numerami identyfikacyjnymi (ID). Wprowadź identyfikatory zaplanowanych zadań na komputerze.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Określa zaplanowane zadanie. Wprowadź zmienną zawierającą obiekty ScheduledJob lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJob, takie jak Get-ScheduledJob polecenie. Można również potokować obiekty ScheduledJob do Unregister-JobTrigger.

Type:ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Usuwa zaplanowane zadania z określonymi nazwami. Wprowadź nazwy co najmniej jednego zaplanowanego zadania na komputerze. Obsługiwane są symbole wieloznaczne.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

ScheduledJobDefinition

Możesz przekazać zaplanowane zadanie do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.