Condividi tramite

Disable-JobTrigger

  • Riferimento
Modulo:
PSScheduledJob

Disabilita i trigger dei processi pianificati.

Sintassi

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

Descrizione

Il Disable-JobTrigger cmdlet disabilita temporaneamente i trigger di processo 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 Get-JobTrigger cmdlet per ottenere i trigger di processo. Inviare quindi tramite pipe i trigger del processo a Disable-JobTrigger o usare il relativo parametro InputObject .

Per disabilitare un trigger di processo, il Disable-JobTrigger cmdlet imposta la proprietà Enabled del trigger di processo su $False. Per riabilitare il trigger di processo, usare il Enable-JobTrigger cmdlet , 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 Disable-ScheduledJob cmdlet , ma se si disabilitano tutti i trigger di processo, l'effetto è uguale alla disabilitazione del 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 Start-Job cmdlet o 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 visualizzare about_Scheduled_Jobs.

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Disabilitare un trigger di processo

In questo esempio viene disabilitato il primo trigger di un processo pianificato nel computer locale.

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

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

Esempio 2: Disabilitare tutti i trigger di processo

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
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

Il primo comando usa il Get-ScheduledJob cmdlet per ottenere i Backup-Archives processi pianificati e Inventory. Un operatore pipeline (|) invia i processi pianificati al Get-JobTrigger cmdlet , che ottiene tutti i trigger di processo dei processi pianificati. Un altro operatore della pipeline invia i trigger di processo al Disable-JobTrigger cmdlet, che li disabilita. Il primo comando usa il Get-ScheduledJob cmdlet per ottenere i processi, perché il relativo parametro Name accetta più nomi.

Il secondo comando visualizza i risultati. Il comando ripete il Get-ScheduledJob comando e Get-JobTrigger . Un operatore pipeline invia i trigger di processo al Format-Table cmdlet , che visualizza i trigger di processo in una tabella. Il Format-Table comando aggiunge una proprietà JobName che visualizza il valore della proprietà Name del processo pianificato nella proprietà JobDefinition dell'oggetto trigger del processo.

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

In questo esempio vengono disabilitati i trigger del processo giornaliero per un processo pianificato in un computer remoto

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

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

Parametri

-Confirm

Richiede conferma 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 Get-JobTrigger comando. È 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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'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 tramite pipe un trigger di processo a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

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