Partilhar 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 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 obtém apenas trabalhos agendados. Ele não recebe 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 para obter trabalhos agendados Get-ScheduledJob 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 no 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 Archive. Este formato de comando permite-lhe procurar 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 canaliza-os para o Get-JobTrigger cmdlet 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 (ID) especificado. 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[]
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Obtém apenas os trabalhos agendados com os nomes especificados. Insira um ou mais nomes de trabalhos agendados no computador. Curingas são suportados. Por padrão, Get-ScheduledJob obtém todos os trabalhos agendados no computador.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Você não pode pipe objetos para este cmdlet.

Saídas

ScheduledJobDefinition

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

Notas

  • 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 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 no disco, consulte about_Scheduled_Jobs_Advanced.
  • Os trabalhos agendados criados 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 Trabalho Agendado. No entanto, não é possível usar os cmdlets Trabalho Agendado para gerenciar tarefas criadas no Agendador de Tarefas.