Compartilhar via

Get-ScheduledJob

  • Referência
Módulo:
PSScheduledJob

Obtém trabalhos agendados no computador local.

Sintaxe

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-ScheduledJob
   [-Name] <String[]>
   [<CommonParameters>]

Description

O cmdlet Get-ScheduledJob obtém trabalhos agendados no computador local. Get-ScheduledJob obtém apenas trabalhos agendados criados pelo usuário atual usando o cmdlet Register-ScheduledJob.

Embora os trabalhos criados usando o cmdlet Register-ScheduledJob apareçam no Agendador de Tarefas, Get-ScheduledJob obtém apenas trabalhos agendados. Ele não obtém tarefas agendadas criadas no Agendador de Tarefas.

Sem parâmetros, Get-ScheduledJob obtém todos os trabalhos agendados no computador. Você pode usar os parâmetros de Get-ScheduledJob para obter trabalhos agendados por ID ou nome e examiná-los ou encaminhá-los para outros cmdlets.

Get-ScheduledJob é um 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: Obter todos os trabalhos agendados

PS C:\> Get-ScheduledJob

Esse comando obtém todos os trabalhos agendados no computador local.

Exemplo 2: Obter trabalhos agendados por nome

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive*

Esse comando obtém todos os trabalhos agendados no computador que têm nomes que incluem Backup ou Arquivo Morto. Esse formato de comando permite que você pesquise trabalhos específicos.

Exemplo 3: Obter trabalhos agendados em computadores remotos

PS C:\> Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Esse comando obtém todos os trabalhos agendados nos computadores listados no arquivo Servers.txt. O comando usa o cmdlet Invoke-Command para executar um comando Get-ScheduleJob em cada computador.

Exemplo 4: redirecionar trabalhos agendados para outros cmdlets

PS C:\> Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Esse comando obtém os gatilhos de trabalho dos trabalhos agendados DailyBackup e WeeklyBackup. Ele usa o cmdlet Get-ScheduledJob para obter os trabalhos agendados e o cmdlet Get-JobTrigger para obter os gatilhos de trabalho dos trabalhos agendados.

Parâmetros

-Id

Obtém apenas os trabalhos agendados com o número de identificação especificado (ID). Insira uma ou mais IDs de trabalhos agendados no computador. Por padrão, Get-ScheduledJob obtém todos os trabalhos agendados no computador.

Tipo:Int32[]
Cargo:0
Valor padrão:All jobs
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Obtém apenas os trabalhos agendados com os nomes especificados. Insira um ou mais nomes de trabalhos agendados no computador. Há suporte para curingas. Por padrão, Get-ScheduledJob obtém todos os trabalhos agendados no computador.

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

Entradas

None

Não é possível redirecionar a entrada para Get-ScheduledJob.

Saídas

ScheduledJobDefinition

Observações

  • Cada trabalho agendado é salvo em um subdiretório do diretório $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs no computador local. O subdiretório é nomeado para o trabalho agendado e contém o arquivo XML para o trabalho agendado e registros de seu histórico de execução. Para obter mais informações sobre trabalhos agendados em disco, consulte about_Scheduled_Jobs_Advanced.
  • Os trabalhos agendados criados no Windows PowerShell aparecem no Agendador de Tarefas na pasta Task Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs. Você pode usar o Agendador de Tarefas para exibir e editar o trabalho agendado.
  • Você pode usar o Agendador de Tarefas, a ferramenta de linha de comando SchTasks.exe e os cmdlets do Agendador de Tarefas para gerenciar trabalhos agendados criados com os cmdlets de Trabalho Agendado. No entanto, você não pode usar os cmdlets de Trabalho Agendado para gerenciar tarefas criadas no Agendador de Tarefas.