New-PSUSchedule

SYNOPSIS

Crea una nueva programación dentro de PSU.

SINTAXIS

Script-Cron (predeterminado)

New-PSUSchedule [-Script] <Script> [-Cron] <String> [-Credential <Variable>] [-TimeZone <String>]
 [-Environment <String>] [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>]
 [-Timeout <Int32>] [-Condition <ScriptBlock>] [-Folder <String>] [-Description <String>] [-Computer <String>]
 [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Script-Continuous

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Continuous]
 [-Delay <TimeSpan>] [-DelaySecond <Int32>] [-DelayMinute <Int32>] [-DelayHour <Int32>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Folder <String>] [-Description <String>] [-Computer <String>]
 [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Script-OneTime

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Folder <String>] [-OneTime <DateTime>] [-Description <String>]
 [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>]
 [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Script-EveryHour

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-EveryHour] [-Minute <Int32>] [-Folder <String>] [-Description <String>]
 [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>]
 [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Script-EveryDay

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] [-EveryDay] [-Folder <String>]
 [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>]
 [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

Script-DayOfWeek

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] [-DayOfWeek] -Day <String[]> [-Folder <String>]
 [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>]
 [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

Script-EveryMonth

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] [-EveryMonth] -DayOfMonth <Int32>
 [-Folder <String>] [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>]
 [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

Script-SpecificMonth

New-PSUSchedule [-Script] <Script> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] -DayOfMonth <Int32> [-SpecificMonth]
 -Month <String[]> [-Folder <String>] [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>]
 [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

Workflow-Cron

New-PSUSchedule -Workflow <Workflow> [-Cron] <String> [-Credential <Variable>] [-TimeZone <String>]
 [-Environment <String>] [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>]
 [-Timeout <Int32>] [-Condition <ScriptBlock>] [-Folder <String>] [-Description <String>] [-Computer <String>]
 [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Workflow-Continuous

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Continuous]
 [-Delay <TimeSpan>] [-DelaySecond <Int32>] [-DelayMinute <Int32>] [-DelayHour <Int32>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Folder <String>] [-Description <String>] [-Computer <String>]
 [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Workflow-OneTime

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Folder <String>] [-OneTime <DateTime>] [-Description <String>]
 [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>]
 [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Workflow-EveryHour

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-EveryHour] [-Minute <Int32>] [-Folder <String>] [-Description <String>]
 [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-ComputerName <String>]
 [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Workflow-EveryDay

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] [-EveryDay] [-Folder <String>]
 [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>]
 [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

Workflow-DayOfWeek

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] [-DayOfWeek] -Day <String[]> [-Folder <String>]
 [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>]
 [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

Workflow-EveryMonth

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] [-EveryMonth] -DayOfMonth <Int32>
 [-Folder <String>] [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>]
 [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

Workflow-SpecificMonth

New-PSUSchedule -Workflow <Workflow> [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>]
 [-Name <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>]
 [-Condition <ScriptBlock>] [-Minute <Int32>] [-Hour <Int32>] -DayOfMonth <Int32> [-SpecificMonth]
 -Month <String[]> [-Folder <String>] [-Description <String>] [-Computer <String>] [-Parameters <Hashtable>]
 [-AvailableInBranch <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

DESCRIPCIÓN

Crea una nueva programación dentro de PSU. Las programaciones le permiten automatizar cuándo se ejecutan los trabajos y ejecutar trabajos de forma continua.

EJEMPLOS

Ejemplo 1

PS C:\> $Script = Get-PSUScript -Name 'Script1.ps1'
PS C:\> New-PSUSchedule -Script $Script -Cron '*/5 * * * *'

Crea una nueva programación que se ejecuta cada cinco minutos.

Ejemplo 2

PS C:\> $Script = Get-PSUScript -Name 'Script1.ps1'
PS C:\> New-PSUSchedule -Script $Script -Cron '*/5 * * * *' -Credential $Secret:Credential

Crea una nueva programación que se ejecuta cada cinco minutos como 'adam'.

Ejemplo 3

PS C:\> $Script = Get-PSUScript -Name 'Script1.ps1'
PS C:\> New-PSUSchedule -Script $Script -Continous -DelayMinute 5

Crea una programación que se ejecuta de forma continua. Iniciará un nuevo trabajo una vez que finalice el anterior, con un retardo de 5 minutos entre ejecuciones.

Ejemplo 4

PS C:\> $Script = Get-PSUScript -Name 'Script1.ps1'
PS C:\> $Time = (Get-Date).AddMinutes(30).ToUniversalTime()
PS C:\> New-PSUSchedule -Script $Script -OneTime $Time -TimeZone "America/Phoenix"

Crea una programación que se ejecuta una vez en 30 minutos en la zona horaria 'America/Phoenix'.

PARÁMETROS

-AppToken

Un token de aplicación para acceder a la API de PSU.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

La dirección HTTP del servidor de la API REST de PSU.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Continuous

Ejecuta un trabajo de forma continua con un retardo opcional entre ejecuciones.

Type: SwitchParameter
Parameter Sets: Script-Continuous, Workflow-Continuous
Aliases:

Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Una credencial para el usuario con el que ejecutar el trabajo. Use New-UACredential para crear este objeto de credencial.

Type: Variable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cron

La programación CRON que se usará para esta programación.

Type: String
Parameter Sets: Script-Cron, Workflow-Cron
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Delay

El retardo entre ejecuciones continuas de trabajos.

Type: TimeSpan
Parameter Sets: Script-Continuous, Workflow-Continuous
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DelayHour

El retardo en horas entre ejecuciones continuas de trabajos.

Type: Int32
Parameter Sets: Script-Continuous, Workflow-Continuous
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DelayMinute

El retardo en minutos entre ejecuciones continuas de trabajos.

Type: Int32
Parameter Sets: Script-Continuous, Workflow-Continuous
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DelaySecond

El retardo en segundos entre ejecuciones continuas de trabajos.

Type: Int32
Parameter Sets: Script-Continuous, Workflow-Continuous
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Script

El script que se va a programar. Use Get-UAScript para recuperar un objeto de script.

Type: Script
Parameter Sets: Script-Cron, Script-Continuous, Script-OneTime, Script-EveryHour, Script-EveryDay, Script-DayOfWeek, Script-EveryMonth, Script-SpecificMonth
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-TimeZone

La zona horaria en la que ejecutar el script. De forma predeterminada, se ejecuta en la zona horaria del usuario actual.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Environment

El nombre del entorno en el que ejecutar el script.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OneTime

Programa en un momento futuro. La zona horaria inicial se determina mediante la propiedad Kind del objeto DateTime. Si el tipo es Unknown, se asumirá que es UTC.

Type: DateTime
Parameter Sets: Script-OneTime, Workflow-OneTime
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Description

Descripción de la programación.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Nombre de la programación que se mostrará en la consola de administración.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Usar credenciales predeterminadas al conectarse a la API de gestión

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Condition

Un bloque de script que determina si esta programación debe ejecutarse. Este bloque de script debe devolver $true o $false.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Ejecuta el comando internamente en lugar de usar la API de gestión. Solo funciona al ejecutar el script desde PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Paused

Si esta programación está en pausa.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Timeout

El tiempo de espera en minutos para esta programación.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RandomDelay

Se aplicará un retardo aleatorio al momento en que se inicie este script. El retardo aleatorio será de entre 0 y 60 segundos.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AvailableInBranch

Ramas en las que se ejecutará esta programación.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Computer

Ordenador o grupo de ordenadores que ejecutará esta programación.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Parameters

Una tabla hash de parámetros que esta programación pasará al script de destino.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RandomDelayMaximum

El número máximo de segundos de retardo.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Si el cmdlet debe ignorar los problemas de certificado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Day

El día de la semana en el que ejecutar el script.

Type: String[]
Parameter Sets: Script-DayOfWeek, Workflow-DayOfWeek
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DayOfMonth

El día del mes en el que ejecutar el script.

Type: Int32
Parameter Sets: Script-EveryMonth, Script-SpecificMonth, Workflow-EveryMonth, Workflow-SpecificMonth
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DayOfWeek

El día de la semana en el que ejecutar el script.

Type: SwitchParameter
Parameter Sets: Script-DayOfWeek, Workflow-DayOfWeek
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EveryDay

Si se debe ejecutar el script todos los días.

Type: SwitchParameter
Parameter Sets: Script-EveryDay, Workflow-EveryDay
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EveryHour

Si se debe ejecutar el script cada hora.

Type: SwitchParameter
Parameter Sets: Script-EveryHour, Workflow-EveryHour
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EveryMonth

Si se debe ejecutar el script todos los meses.

Type: SwitchParameter
Parameter Sets: Script-EveryMonth, Workflow-EveryMonth
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Hour

La hora a la que ejecutar el script.

Type: Int32
Parameter Sets: Script-EveryDay, Script-DayOfWeek, Script-EveryMonth, Script-SpecificMonth, Workflow-EveryDay, Workflow-DayOfWeek, Workflow-EveryMonth, Workflow-SpecificMonth
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Minute

El minuto en el que ejecutar el script.

Type: Int32
Parameter Sets: Script-EveryHour, Script-EveryDay, Script-DayOfWeek, Script-EveryMonth, Script-SpecificMonth, Workflow-EveryHour, Workflow-EveryDay, Workflow-DayOfWeek, Workflow-EveryMonth, Workflow-SpecificMonth
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Month

Los meses en los que ejecutar el script.

Type: String[]
Parameter Sets: Script-SpecificMonth, Workflow-SpecificMonth
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SpecificMonth

Si se debe ejecutar el script en meses específicos.

Type: SwitchParameter
Parameter Sets: Script-SpecificMonth, Workflow-SpecificMonth
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Folder

La carpeta en la que almacenar esta programación. Esto es solo de uso visual.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Workflow

Especifica el flujo de trabajo de destino.

Type: Workflow
Parameter Sets: Workflow-Cron, Workflow-Continuous, Workflow-OneTime, Workflow-EveryHour, Workflow-EveryDay, Workflow-DayOfWeek, Workflow-EveryMonth, Workflow-SpecificMonth
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para más información, consulte about_CommonParameters.

ENTRADAS

UniversalAutomation.Script

SALIDAS

System.Object

NOTAS

ENLACES RELACIONADOS