Share via

Enable-JobTrigger

  • Referenz
Modul:
PSScheduledJob

Aktiviert die Auftragstrigger geplanter Aufträge.

Syntax

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

Beschreibung

Das Cmdlet Enable-JobTrigger aktiviert Auftragstrigger von geplanten Aufträgen erneut, z. B. solche, die mithilfe des Cmdlets Disable-JobTrigger deaktiviert wurden. Aktivierte und erneut aktivierte Auftragstrigger können geplante Aufträge sofort starten. Es besteht keine Notwendigkeit, Windows oder Windows PowerShell neu zu starten.

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

Um einen Auftragstrigger zu aktivieren, legt das Cmdlet Enable-JobTrigger die Enabled-Eigenschaft des Auftragstriggers auf $True fest.

Enable-ScheduledJob ist eine Sammlung von Cmdlets zur Auftragsplanung im PSScheduledJob-Modul, das in Windows PowerShell enthalten ist.

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

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Aktivieren eines Auftragstriggers

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

Dieser Befehl aktiviert den ersten Trigger (ID=1) des geplanten Auftrags Backup-Archives auf dem lokalen Computer.

Der Befehl verwendet das Cmdlet Get-JobTrigger, um den Auftragstrigger abzurufen. Ein Pipelineoperator sendet den Auftragstrigger an das Enable-JobTrigger-Cmdlet, durch das er aktiviert wird.

Beispiel 2: Aktivieren aller Auftragstrigger

PS C:\> Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

Der Befehl verwendet das Cmdlet Get-ScheduledJob, um die geplanten Aufträge auf dem lokalen Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Cmdlet Get-JobTrigger, das alle Auftragstrigger der geplanten Aufträge abruft. Ein weiterer Pipelineoperator sendet die Auftragstrigger an das Enable-JobTrigger-Cmdlet, durch das sie aktiviert werden.

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

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

Dieser Befehl aktiviert die AtLogon-Auftragstrigger für den geplanten Auftrag DeployPackage auf dem Remotecomputer Server01 erneut.

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 Auftragstrigger des geplanten Auftrags DeployPackage abzurufen. Ein Pipelineoperator sendet die Auftragstrigger an das Cmdlet Where-Object, das nur AtLogon-Auftragstrigger zurückgibt. Ein Pipelineoperator sendet die AtLogon-Auftragstrigger an das Cmdlet Enable-JobTrigger , das sie aktiviert.

Beispiel 4: Anzeigen deaktivierter Auftragstrigger

PS C:\> Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
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

Dieser Befehl zeigt alle deaktivierten Auftragstrigger aller geplanten Aufträge in einer Tabelle an. Sie können einen Befehl wie diesen verwenden, um Auftragstrigger zu ermitteln, die u. U. aktiviert werden müssen.

Der Befehl verwendet das Cmdlet Get-ScheduledJob, um die geplanten Aufträge auf dem lokalen Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Cmdlet Get-JobTrigger, das alle Auftragstrigger der geplanten Aufträge abruft. Ein anderer Pipelineoperator sendet die Auftragstrigger an das Cmdlet Where-Object, das nur deaktivierte Auftragstrigger zurückgibt, d. h., wenn der Wert der Enabled-Eigenschaft des Auftragstriggers nicht (!) true ist.

Ein anderer Pipelineoperator sendet die deaktivierten Auftragstrigger an das Cmdlet Format-Table, das die ausgewählten Eigenschaften der Auftragstrigger in einer Tabelle anzeigt. Die Eigenschaften umfassen eine neue JobName-Eigenschaft, die den Namen des geplanten Auftrags in der JobDefinition-Eigenschaft des Auftragstriggers anzeigt.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-InputObject

Gibt den zu aktivierenden Auftragstrigger an. 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 Enable-JobTrigger übergeben.

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

-PassThru

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

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

-WhatIf

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

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

Eingaben

ScheduledJobTrigger

Sie können Auftragstrigger an Enable-JobTrigger übergeben.

Ausgaben

None

Dieses Cmdlet generiert keine Ausgabe.

Hinweise

  • Enable-JobTrigger generiert keine Fehler oder Warnungen, wenn Sie einen bereits aktivierten Auftragstrigger aktivieren.