Disable-JobTrigger

Módulo:: PSScheduledJob

Desabilita os gatilhos de trabalho de trabalhos agendados.

Sintaxe

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

Description

O cmdlet Disable-JobTrigger desabilita temporariamente os gatilhos de trabalho de trabalhos agendados. Desabilitar preserva todas as propriedades do gatilho de trabalho, mas impede que o gatilho de trabalho inicie o trabalho agendado.

Para usar esse cmdlet, use o cmdlet Get-JobTrigger para obter os gatilhos de trabalho. Em seguida, canalize os gatilhos de trabalho para Disable-JobTrigger ou use seu parâmetro InputObject .

Para desabilitar um gatilho de trabalho, o cmdlet Disable-JobTrigger define a propriedade Enabled do gatilho de trabalho como $False. Para reabilitar o gatilho de trabalho, use o cmdlet Enable-JobTrigger, que define a propriedade Enabled do gatilho de trabalho como $True. Desabilitar um gatilho de trabalho não desabilita o trabalho agendado, como é feito pelo cmdlet Disable-ScheduledJob, mas se você desabilitar todos os gatilhos de trabalho, o efeito será o mesmo que desabilitar o trabalho agendado.

Se você desabilitar um trabalho agendado ou desabilitar todos os gatilhos de trabalho de um trabalho agendado, ainda poderá iniciar o trabalho usando o cmdlet Start-Job ou usar o trabalho agendado desabilitado como modelo.

Disable-ScheduledJob faz parte de uma coleção de cmdlets de agendamento de trabalho no módulo PSScheduledJob incluído no Windows PowerShell.

Para obter mais informações sobre trabalhos agendados, consulte os tópicos sobre no módulo PSScheduledJob. Importe o módulo PSScheduledJob e digite: Get-Help about_Scheduled* ou veja about_Scheduled_Jobs.

Esse cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Desabilitar um gatilho de trabalho

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

Esse comando desabilita o primeiro gatilho (ID=1) do Backup-Archives trabalho agendado no computador local.

O comando usa o cmdlet Get-JobTrigger para obter o gatilho de trabalho. Um operador de pipeline envia o gatilho de trabalho para o cmdlet Disable-JobTrigger , que o desabilita.

Exemplo 2: Desabilitar todos os gatilhos de trabalho

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

Esses comandos desabilitam todos os gatilhos de trabalho em dois trabalhos agendados e exibem os resultados.

Exemplo 3: Desabilitar o gatilho de trabalho de um trabalho agendado em um computador remoto

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

Esse comando desabilita os gatilhos de trabalho diários no trabalho agendado DeployPackage no computador remoto Server01.

O comando usa o cmdlet Invoke-Command para executar os comandos no computador Server01. O comando remoto usa o cmdlet Get-JobTrigger para obter os gatilhos de trabalho do trabalho agendado DeployPackage. Um operador de pipeline envia os gatilhos de trabalho para o cmdlet Where-Object, que retorna apenas gatilhos de trabalho diários. Um operador de pipeline envia os gatilhos de trabalho diários para o cmdlet Disable-JobTrigger , que os desabilita.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifica o gatilho de trabalho a ser desabilitado. Insira uma variável que contenha objetos ScheduledJobTrigger ou digite um comando ou expressão que obtém objetos scheduledJobTrigger, como um comando Get-JobTrigger. Você também pode canalizar um objeto ScheduledJobTrigger para Disable-JobTrigger.

Tipo:	ScheduledJobTrigger[]
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

ScheduledJobTrigger

Você pode canalizar gatilhos de trabalho para Disable-JobTrigger.

Saídas

None

Esse cmdlet não gera nenhuma saída.

Observações

Disable-JobTrigger não gerará erros ou avisos se você desabilitar um gatilho de trabalho que já esteja desabilitado.

Compartilhar via