New-PSUSchedule

SYNOPSIS

Crée une nouvelle planification dans PSU.

SYNTAXE

Script-Cron (Par défaut)

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>]

DESCRIPTION

Crée une nouvelle planification dans PSU. Les planifications vous permettent d'automatiser le moment où les tâches sont exécutées et d'exécuter des tâches en continu.

EXEMPLES

Exemple 1

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

Crée une nouvelle planification qui s'exécute toutes les cinq minutes.

Exemple 2

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

Crée une nouvelle planification qui s'exécute toutes les cinq minutes en tant que « adam ».

Exemple 3

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

Crée une planification qui s'exécute en continu. Elle démarre une nouvelle tâche dès que la précédente est terminée, avec un délai de 5 minutes entre les exécutions.

Exemple 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"

Crée une planification qui s'exécute une seule fois dans 30 minutes dans le fuseau horaire « America/Phoenix ».

PARAMÈTRES

-AppToken

Un jeton d'appli pour accéder à l'API PSU.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

L'adresse HTTP du serveur d'API REST PSU.

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

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

-Continuous

Exécute une tâche en continu avec un délai facultatif entre les exécutions.

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

Un identifiant pour l'utilisateur sous lequel exécuter la tâche. Utilisez New-UACredential pour créer cet objet d'identifiant.

Type: Variable
Parameter Sets: (All)
Aliases:

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

-Cron

La planification CRON à utiliser pour cette planification.

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

Le délai entre les exécutions de tâches en continu.

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

Le délai en heures entre les exécutions de tâches en continu.

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

Le délai en minutes entre les exécutions de tâches en continu.

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

Le délai en secondes entre les exécutions de tâches en continu.

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

Le script à planifier. Utilisez Get-UAScript pour récupérer un objet 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

Le fuseau horaire dans lequel exécuter le script. Par défaut, il s'exécute dans le fuseau horaire de l'utilisateur actuel.

Type: String
Parameter Sets: (All)
Aliases:

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

-Environment

Le nom de l'environnement dans lequel exécuter le script.

Type: String
Parameter Sets: (All)
Aliases:

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

-OneTime

Planifie à un moment dans le futur. Le fuseau horaire initial est déterminé par la propriété Kind de l'objet DateTime. Si le kind est Unknown, il sera présumé être 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

Description de la planification.

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Nom de la planification à afficher dans la console d'administration.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Utiliser les identifiants par défaut lors de la connexion à l'API de gestion

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Condition

Un bloc de script qui détermine si cette planification doit s'exécuter. Ce bloc de script doit retourner $true ou $false.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

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

-Integrated

Exécute la commande en interne plutôt qu'en utilisant l'API de gestion. Fonctionne uniquement lors de l'exécution d'un script depuis PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Paused

Indique si cette planification est en pause.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Timeout

Le délai d'expiration en minutes pour cette planification.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-RandomDelay

Un délai aléatoire sera appliqué au démarrage de ce script. Le délai aléatoire sera entre 0 et 60 secondes.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AvailableInBranch

Les branches dans lesquelles cette planification s'exécutera.

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

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

-Computer

L'ordinateur ou le groupe d'ordinateurs qui exécutera cette planification.

Type: String
Parameter Sets: (All)
Aliases:

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

-Parameters

Une table de hachage de paramètres que cette planification transmettra au script cible.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-RandomDelayMaximum

Le nombre maximal de secondes de délai.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Indique si l'applet de commande doit ignorer les problèmes de certificat.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Day

Le jour de la semaine où exécuter le 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

Le jour du mois où exécuter le 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

Le jour de la semaine où exécuter le 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

Indique s'il faut exécuter le script chaque jour.

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

Indique s'il faut exécuter le script chaque heure.

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

Indique s'il faut exécuter le script chaque mois.

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

L'heure à laquelle exécuter le 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

La minute à laquelle exécuter le 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

Les mois où exécuter le 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

Indique s'il faut exécuter le script durant des mois précis.

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

Le dossier dans lequel stocker cette planification. Ceci est à usage visuel seulement.

Type: String
Parameter Sets: (All)
Aliases:

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

-Cookies

Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Workflow

Spécifie le workflow à cibler.

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

Paramètres communs

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'information, voir about_CommonParameters.

ENTRÉES

UniversalAutomation.Script

SORTIES

System.Object

NOTES

LIENS CONNEXES