Freigeben über

Disable-JobTrigger

  • Referenz
Modul:
PSScheduledJob

Deaktiviert die Auftragstrigger von geplanten Aufträgen.

Syntax

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das cmdlet Disable-JobTrigger deaktiviert vorübergehend die Auftragstrigger von geplanten Aufträgen. Durch das Deaktivieren bleiben alle Auftragstriggereigenschaften erhalten, der Auftragstrigger wird jedoch daran gehindert, den geplanten Auftrag zu starten.

Verwenden Sie zum Verwenden dieses Cmdlets das cmdlet Get-JobTrigger, um die Auftragstrigger abzurufen. Übergeben Sie den Auftrag dann an Disable-JobTrigger- oder verwenden Sie dessen InputObject Parameter.

Um einen Auftragstrigger zu deaktivieren, legt das cmdlet Disable-JobTrigger die Enabled-Eigenschaft des Auftragstriggers auf $False fest. Um den Auftragstrigger erneut zu aktivieren, verwenden Sie das cmdlet Enable-JobTrigger, das die eigenschaft Enabled des Auftragstriggers auf $True festlegt. Durch das Deaktivieren eines Auftragstriggers wird der geplante Auftrag nicht deaktiviert, z. B. durch das Cmdlet Disable-ScheduledJob, aber wenn Sie alle Auftragstrigger deaktivieren, entspricht der Effekt dem Deaktivieren des geplanten Auftrags.

Wenn Sie einen geplanten Auftrag deaktivieren oder alle Auftragstrigger eines geplanten Auftrags deaktivieren, können Sie den Auftrag trotzdem mithilfe des cmdlets Start-Job starten oder den deaktivierten geplanten Auftrag als Vorlage verwenden.

Disable-ScheduledJob- ist eine Sammlung von Auftragsplanungs-Cmdlets im PSScheduledJob Modul, das in Windows PowerShell enthalten ist.

Weitere Informationen zu geplanten Aufträgen finden Sie in den Themen "Info" im PSScheduledJob-Modul. Importieren Sie das PSScheduledJob-Modul, und geben Sie dann Folgendes ein: Get-Help about_Scheduled* oder about_Scheduled_Jobs anzeigen.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Deaktivieren eines Auftragstriggers

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

Mit diesem Befehl wird der erste Trigger (ID=1) des Backup-Archives geplanten Auftrags auf dem lokalen Computer deaktiviert.

Der Befehl verwendet das Cmdlet Get-JobTrigger, um den Auftragstrigger abzurufen. Ein Pipelineoperator sendet den Auftragsauslöser an das cmdlet Disable-JobTrigger, das ihn deaktiviert.

Beispiel 2: Alle Auftragstrigger deaktivieren

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Mit diesen Befehlen werden alle Auftragstrigger für zwei geplante Aufträge deaktiviert und die Ergebnisse angezeigt.

Beispiel 3: Deaktivieren des Auftragstriggers eines geplanten Auftrags auf einem Remotecomputer

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

Mit diesem Befehl werden die täglichen Auftragsauslöser für den geplanten DeployPackage-Auftrag auf dem Server01-Remotecomputer deaktiviert.

Der Befehl verwendet das Cmdlet Invoke-Command, um die Befehle auf dem Server01-Computer auszuführen. Der Remotebefehl verwendet das Cmdlet Get-JobTrigger, um die Auftragsauslöser des geplanten DeployPackage-Auftrags abzurufen. Ein Pipelineoperator sendet die Auftragstrigger an das Cmdlet Where-Object, das nur tägliche Auftragsauslöser zurückgibt. Ein Pipelineoperator sendet die täglichen Auftragsauslöser an das cmdlet Disable-JobTrigger, das sie deaktiviert.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt den Auftragstrigger an, der deaktiviert werden soll. Geben Sie eine Variable ein, die ScheduledJobTrigger--Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der ScheduledJobTrigger--Objekte abruft, z. B. einen Get-JobTrigger Befehl. Sie können auch ein ScheduledJobTrigger--Objekt an Disable-JobTrigger-senden.

Typ:ScheduledJobTrigger[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ScheduledJobTrigger

Sie können Auftragsauslöser an Disable-JobTrigger-.

Ausgaben

None

Dieses Cmdlet generiert keine Ausgabe.

Hinweise

  • Disable-JobTrigger- keine Fehler oder Warnungen generiert, wenn Sie einen bereits deaktivierten Auftragsauslöser deaktivieren.