Cria uma instância de tarefa agendada.
Sintaxe
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Descrição
O cmdlet New-ScheledTask cria um objeto que contém a definição de uma tarefa agendada.New-ScheduledTask não registra automaticamente o objeto com o serviço Task Scheduler.
É possível registrar uma tarefa para executar qualquer uma das seguintes aplicações ou tipos de arquivo: Aplicações Win32, aplicações Win16, aplicações OS/2, aplicações MS-DOS, ficheiros batch (.bat), ficheiros de comandos (.cmd), ou qualquer tipo de ficheiro devidamente registado.
Exemplos
Exemplo 1: Definir uma tarefa agendada e registrá-la posteriormente
PS C:\> $A = New-ScheduledTaskAction -Execute "Taskmgr.exe"PS C:\> $T = New-ScheduledTaskTrigger -AtLogonPS C:\> $P = New-ScheduledTaskPrincipal "Contoso\Administrator"PS C:\> $S = New-ScheduledTaskSettingsSetPS C:\> $D = New-ScheduledTask -Action $A -Principal $P -Trigger $T -Settings $SPS C:\> Register-ScheduledTask T1 -InputObject $DNeste exemplo, o conjunto de comandos usa vários cmdlets e variáveis para definir e então registrar uma tarefa agendada.
O primeiro comando usa o comando New-ScheduledTaskAction cmdlet para atribuir o arquivo executável tskmgr.exe à variável $A.
O segundo comando usa o comando New-ScheduledTaskTrigger cmdlet para atribuir o valor AtLogon à variável $T.
O terceiro comando atribui o princípio da tarefa agendada Contoso\Administrator à variável $P.
O quarto comando utiliza o comando New-ScheduledTaskSettingsSet cmdlet para atribuir um objecto de definições de tarefa à variável $S.
O quinto comando cria uma nova tarefa e atribui a definição da tarefa à variável $D.
O sexto comando (hipoteticamente) roda em um momento posterior. Ele registra a nova tarefa agendada e a define usando a variável $D.
Parâmetros
Especifica um array de itens de trabalho para uma tarefa a ser executada. Quando você especifica múltiplas ações, elas são executadas sequencialmente. Uma tarefa pode ter até 32 ações.
| Type: | CimInstância |
| Posição: | 0 |
| Valor padrão: | Nenhum |
| Aceitar entrada do pipeline: | Falso |
| Aceitar caracteres wildcard: | Falso |
Executar o cmdlet como um trabalho de fundo. Use este parâmetro para executar comandos que levam um longo tempo para serem completados.
| Type: | SwitchParameter |
| Posição: | Nome: |
| Valor por defeito: | Nenhum |
| Aceitar entrada do pipeline: | Falso |
| Aceitar caracteres wildcard: | Falso |
Executar a cmdlet numa sessão remota ou num computador remoto.Introduza um nome de computador ou um objecto de sessão, tal como a saída de uma New-CimSession ou Get-CimSession cmdlet.O padrão é a sessão atual no computador local.
| Type: | CimSession |
| Aliases: | Session |
| Posição: | Nome |
| Valor por defeito: | Nenhum |
| Aceitar entrada do gasoduto: | Falso |
| Aceitar caracteres wildcard: | Falso |
Descreve a tarefa de forma breve.
| Tipo: | Calça |
| Posição: | 4 |
| Valor por defeito: | Nenhum |
| Aceitar entrada da conduta: | Falso |
| Aceitar caracteres wildcard: | Falso |
Especifica o contexto de segurança em que uma tarefa corre.
| Tipo: | CimInstância |
| Posição: | 3 |
| Valor por defeito: | Nenhum |
| Aceitar entrada do pipeline: | Falso |
| Aceitar caracteres curinga: | Falso |
Especifica um objeto de configuração que o serviço Agendador de Tarefas usa para determinar como executar uma tarefa.
| Tipo: | CimInstância |
| Posição: | 2 |
| Valor por defeito: | Nenhum |
| Aceitar entrada do pipeline: | Falso |
| Aceitar caracteres wildcard: | Falso |
Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet.Se este parâmetro for omitido ou se for introduzido um valor de 0, então o Windows PowerShell® calcula um limite de aceleração ideal para o cmdlet com base no número de cmdlets CIM que estão a ser executados no computador.O limite de aceleração aplica-se apenas à cmdlet actual, não à sessão ou ao computador.
| Tipo: | Int32 |
| Posição: | Nomeado |
| Valor por defeito: | Nenhum |
| Aceitar entrada da tubagem: | Falso |
| Aceitar caracteres curinga: | Falso |
Especifica uma matriz de um ou mais objetos de gatilho que causam o início de uma tarefa agendada.
| Type: | CimInstância |
| Posição: | 1 |
| Valor por defeito: | Nenhum |
| Aceitar entrada do gasoduto: | Falso |
| Aceitar caracteres wildcard: | Falso |
Eliminares
CimInstância
- Tarefa programada de Desactivação
- Enable-ScheduledTask
- Export-ScheduledTask
- Get-ScheduledTask
- New-ScheduledTaskAction
- New-ScheduledTaskSettingsSet
- New-ScheduledTaskPrincipal
- New-ScheduledTaskTrigger
- Register-ScheduledTask
- Set-ScheduledTask
- Start-ScheduledTask
- Stop-ScheduledTask
- Unregister-ScheduledTask
>
>