Condividi tramite

Disable-JobTrigger

  • Riferimento
Modulo:
PSScheduledJob

Disabilita i trigger dei processi pianificati.

Sintassi

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

Descrizione

Il cmdlet Disable-JobTrigger disabilita temporaneamente i trigger dei processi pianificati. La disabilitazione mantiene tutte le proprietà di un trigger di processo, ma gli impedisce di avviare il processo pianificato.

Per usare questo cmdlet, usare il cmdlet Get-JobTrigger per ottenere i trigger del processo. Inviare quindi i trigger di processo a Disable-JobTrigger oppure usare il relativo parametro InputObject.

Per disabilitare un trigger di processo, il cmdlet Disable-JobTrigger imposta la proprietà Enabled del trigger di processo su $False. Per riabilitare il trigger del processo, usare il cmdlet Enable-JobTrigger, che imposta la proprietà Enabled del trigger di processo su $True. La disabilitazione di un trigger di processo non disabilita il processo pianificato, ad esempio viene eseguito dal cmdlet Disable-ScheduledJob, ma se si disabilitano tutti i trigger di processo, l'effetto equivale a disabilitare il processo pianificato.

Se si disabilita un processo pianificato o si disabilitano tutti i trigger di processo di un processo pianificato, è comunque possibile avviare il processo usando il cmdlet Start-Job oppure usare il processo pianificato disabilitato come modello.

Disable-ScheduledJob è una raccolta di cmdlet di pianificazione dei processi nel modulo PSScheduledJob incluso in Windows PowerShell.

Per altre informazioni sui lavori pianificati, vedere gli argomenti Informazioni nel modulo PSScheduledJob. Importare il modulo PSScheduledJob e quindi digitare: Get-Help about_Scheduled* o vedere about_Scheduled_Jobs.

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Disabilitare un trigger di processo

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

Questo comando disabilita il primo trigger (ID = 1) del processo pianificato Backup-Archives sul computer locale.

Il comando usa il cmdlet Get-JobTrigger per ottenere il trigger del processo. Un altro operatore pipeline invia il trigger di processo al cmdlet Disable-JobTrigger, che lo disabilita.

Esempio 2: Disabilitare tutti i trigger di processo

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

Questi comandi disabilitano tutti i trigger di processo in due processi pianificati e visualizzano i risultati.

Esempio 3: Disabilitare il trigger di processo di un processo pianificato in un computer remoto

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

Questo comando disabilita i trigger di processo giornalieri nel processo pianificato DeployPackage sul computer remoto Server01.

Il comando usa il cmdlet Invoke-Command per eseguire i comandi nel computer Server01. Il comando remoto usa il cmdlet Get-JobTrigger per ottenere i trigger di processo del processo pianificato DeployPackage. Un operatore pipeline invia i trigger di processo al cmdlet Where-Object, che restituisce solo trigger di processo giornalieri. Un operatore pipeline invia i trigger di processo giornalieri al cmdlet Disable-JobTrigger , che li disabilita.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-InputObject

Specifica il trigger di processo da disabilitare. Immettere una variabile contenente oggetti ScheduledJobTrigger o digitare un comando o un'espressione che ottiene oggetti ScheduledJobTrigger , ad esempio un comando Get-JobTrigger. È anche possibile inviare tramite pipe un oggetto ScheduledJobTrigger a Disable-JobTrigger.

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

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

ScheduledJobTrigger

È possibile inviare trigger di processo tramite pipe a Disable-JobTrigger.

Output

None

Questo cmdlet non genera alcun output.

Note

  • Disable-JobTrigger non genera errori o avvisi se si disabilita un trigger di processo già disabilitato.