Disable-JobTrigger

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

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.

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.

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.

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.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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

Dieses Cmdlet generiert keine Ausgabe.

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