Crea una instancia de tarea programada.
Sintaxis
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Descripción
El cmdlet New-ScheduledTask crea un objeto que contiene la definición de una tarea programada.New-ScheduledTask no registra automáticamente el objeto con el servicio del Programador de tareas.
Puede registrar una tarea para ejecutar cualquiera de los siguientes tipos de aplicaciones o archivos: Aplicaciones Win32, aplicaciones Win16, aplicaciones OS/2, aplicaciones MS-DOS, archivos por lotes (.bat), archivos de comandos (.cmd) o cualquier tipo de archivo debidamente registrado.
Ejemplos
Ejemplo 1: Definir una tarea programada y registrarla 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 $DEn este ejemplo, el conjunto de comandos utiliza varios cmdlets y variables para definir y luego registrar una tarea programada.
El primer comando utiliza el cmdlet New-ScheduledTaskAction para asignar el archivo ejecutable tskmgr.exe a la variable $A.
El segundo comando utiliza el cmdlet New-ScheduledTaskTrigger para asignar el valor AtLogon a la variable $T.
El tercer comando asigna el principal de la tarea programada Contoso\Administrator a la variable $P.
El cuarto comando utiliza el cmdlet New-ScheduledTaskSet para asignar un objeto de configuración de la tarea a la variable $S.
El quinto comando crea una nueva tarea y asigna la definición de la tarea a la variable $D.
El sexto comando (hipotéticamente) se ejecuta en un momento posterior.Registra la nueva tarea programada y la define utilizando la variable $D.
Parámetros
Especifica una matriz de elementos de trabajo para que se ejecute una tarea.Cuando se especifican varias acciones, éstas se ejecutan secuencialmente.Una tarea puede tener hasta 32 acciones.
| Tipo: | CimInstance |
| Posición: | 0 |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Falso |
Ejecuta el cmdlet como un trabajo en segundo plano. Utilice este parámetro para ejecutar comandos que tardan mucho en completarse.
| Tipo: | SwitchParameter |
| Posición: | Nombre |
| Valor por defecto: | Ninguno |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Falso |
Ejecuta el cmdlet en una sesión remota o en un equipo remoto.Introduzca un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession.El valor predeterminado es la sesión actual en el equipo local.
| Tipo: | CimSession |
| Aliases: | Session |
| Posición: | Nombre |
| Valor por defecto: | Ninguno |
| Acepta entrada de canalización: | Falso |
| Acepta caracteres comodín: | Falso |
Describe brevemente la tarea.
| Tipo: | Cadena |
| Posición: | 4 |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Falso |
Especifica el contexto de seguridad en el que se ejecuta una tarea.
| Tipo: | CimInstance |
| Posición: | 3 |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Falso |
Especifica un objeto de configuración que el servicio Programador de tareas utiliza para determinar cómo ejecutar una tarea.
| Tipo: | CimInstance |
| Posición: | 2 |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Falso |
Especifica el número máximo de operaciones concurrentes que se pueden establecer para ejecutar el cmdlet.Si se omite este parámetro o se introduce un valor de 0, Windows PowerShell® calcula un límite de aceleración óptimo para el cmdlet basado en el número de cmdlets CIM que se están ejecutando en el equipo.El límite de aceleración sólo se aplica al cmdlet actual, no a la sesión ni al equipo.
| Tipo: | Int32 |
| Posición: | Nombrado |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Falso |
Especifica una matriz de uno o más objetos disparadores que provocan el inicio de una tarea programada.
Un desencadenante es un conjunto de criterios que inicia una tarea programada cuando se cumplen los criterios.Puede utilizar un desencadenante basado en el tiempo o un desencadenante basado en el evento para iniciar una tarea, y uno o más desencadenantes pueden iniciar una tarea.Una tarea puede tener hasta 48 desencadenantes.Para obtener más información sobre los desencadenantes, consulte Desencadenantes.
| Tipo: | CimInstance |
| Posición: | 1 |
| Valor por defecto: | Ninguno |
| Aceptar entrada de tuberías: | Falso |
| Aceptar caracteres comodín: | False |
Salidas
CimInstance
- Disable-ScheduledTask
- Enable-ScheduledTask
- Export-ScheduledTask
- Get-ScheduledTask
- New-ScheduledTaskAction
- New-ScheduledTaskSetSet
- New-ScheduledTaskPrincipal
- New-ScheduledTaskTrigger
- Register-ScheduledTask
- Set-ScheduledTask
- Start-ScheduledTask
- Stop-ScheduledTask
- Unregister-ScheduledTask