Compartilhar via

Get-ScheduledJob

  • Referência
Módulo:
PSScheduledJob

Obtém os trabalhos agendados no computador local.

Sintaxe

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

Description

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

Embora os trabalhos criados usando o Register-ScheduledJob cmdlet apareçam no Agendador de Tarefas, Get-ScheduledJob ele obtém apenas trabalhos agendados. Ele não obtém os trabalhos agendados que são criados 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 canalizá-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 o módulo PSScheduledJob. Importe o módulo PSScheduledJob e digite: Get-Help about_Scheduled* ou consulte about_Scheduled_Jobs.

Este cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Obter todos os trabalhos agendados

Este exemplo obtém todos os trabalhos agendados no computador local.

Get-ScheduledJob

Exemplo 2: Obter trabalhos agendados por nome

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

Get-ScheduledJob -Name *Backup*, *Archive*

Exemplo 3: Obter trabalhos agendados em computadores remotos

Este exemplo obtém todos os trabalhos agendados nos computadores listados em um arquivo de texto.

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

O comando usa o Invoke-Command cmdlet para executar um Get-ScheduleJob comando em cada computador.

Exemplo 4: Canalizar trabalhos agendados para outros cmdlets

Este exemplo obtém os gatilhos de trabalho de trabalhos agendados especificados

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Ele usa o Get-ScheduledJob cmdlet para obter os trabalhos agendados e os canaliza para o Get-JobTrigger cmdlet para obter os gatilhos de trabalho dos trabalhos agendados.

Parâmetros

-Id

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

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

-Name

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

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

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

ScheduledJobDefinition

Esse cmdlet retorna a definição de um trabalho agendado.

Observações

  • Cada trabalho agendado é salvo em um subdiretório do $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs diretório no computador local. O subdiretório é nomeado de acordo com o trabalho agendado e contém o arquivo XML para o trabalho agendado e registros do histórico de execução. Para obter mais informações sobre trabalhos agendados no disco, consulte about_Scheduled_Jobs_Advanced.
  • Os trabalhos agendados que você cria no Windows PowerShell aparecem no Agendador de Tarefas na pasta Agendador Library\Microsoft\Windows\PowerShell\ScheduledJobs de Tarefas. Você pode usar o Agendador de tarefas para exibir e editar o trabalho agendado.
  • Você pode usar o Agendador de Tarefas, a SchTasks.exe ferramenta de linha de comando 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 do Trabalho agendado para gerenciar tarefas que você cria no Agendador de tarefas.