New-PSUSchedule

SINOSSI

Crea una nuova pianificazione in PSU.

SINTASSI

Script-Cron (Predefinito)

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

DESCRIZIONE

Crea una nuova pianificazione in PSU. Le pianificazioni consentono di automatizzare il momento in cui i processi vengono eseguiti e di eseguirli in modo continuo.

ESEMPI

Esempio 1

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

Crea una nuova pianificazione che viene eseguita ogni cinque minuti.

Esempio 2

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

Crea una nuova pianificazione che viene eseguita ogni cinque minuti come 'adam'.

Esempio 3

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

Crea una pianificazione che viene eseguita in modo continuo. Avvierà un nuovo processo al termine di quello precedente con un ritardo di 5 minuti tra le esecuzioni.

Esempio 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 pianificazione che viene eseguita una volta tra 30 minuti nel fuso orario 'America/Phoenix'.

PARAMETRI

-AppToken

Un token dell'app per accedere all'API di PSU.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

L'indirizzo HTTP del server dell'API REST di PSU.

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

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

-Continuous

Esegue un processo in modo continuo con un ritardo facoltativo tra le esecuzioni.

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 credenziale dell'utente con cui eseguire il processo. Usi New-UACredential per creare questo oggetto credenziale.

Type: Variable
Parameter Sets: (All)
Aliases:

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

-Cron

La pianificazione CRON da usare per questa pianificazione.

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

Il ritardo tra le esecuzioni continue del processo.

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

Il ritardo in ore tra le esecuzioni continue del processo.

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

Il ritardo in minuti tra le esecuzioni continue del processo.

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

Il ritardo in secondi tra le esecuzioni continue del processo.

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

Lo script da pianificare. Usi Get-UAScript per recuperare un oggetto 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

Il fuso orario in cui eseguire lo script. Per impostazione predefinita, viene eseguito nel fuso orario dell'utente corrente.

Type: String
Parameter Sets: (All)
Aliases:

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

-Environment

Il nome dell'ambiente in cui eseguire lo script.

Type: String
Parameter Sets: (All)
Aliases:

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

-OneTime

Pianifica a un orario futuro. Il fuso orario iniziale è determinato dalla proprietà Kind dell'oggetto DateTime. Se il tipo è Unknown, si presume che sia 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

Descrizione della pianificazione.

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Nome della pianificazione da visualizzare nella console di amministrazione.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Usa le credenziali predefinite durante la connessione all'API di gestione

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Condition

Un blocco di script che determina se questa pianificazione deve essere eseguita. Questo blocco di script deve restituire $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

Esegue il comando internamente anziché usare l'API di gestione. Funziona solo quando si esegue lo script all'interno di PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Paused

Indica se questa pianificazione è in pausa.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Timeout

Il timeout in minuti per questa pianificazione.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-RandomDelay

Verrà applicato un ritardo casuale all'avvio di questo script. Il ritardo casuale sarà compreso tra 0 e 60 secondi.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AvailableInBranch

I branch in cui verrà eseguita questa pianificazione.

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

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

-Computer

Computer o gruppo di computer che eseguirà questa pianificazione.

Type: String
Parameter Sets: (All)
Aliases:

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

-Parameters

Una tabella hash di parametri che questa pianificazione passerà allo script di destinazione.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-RandomDelayMaximum

Il numero massimo di secondi di ritardo.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Indica se il cmdlet deve ignorare i problemi relativi ai certificati.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Day

Il giorno della settimana in cui eseguire lo 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

Il giorno del mese in cui eseguire lo 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

Il giorno della settimana in cui eseguire lo 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

Indica se eseguire lo script ogni giorno.

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

Indica se eseguire lo script ogni ora.

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

Indica se eseguire lo script ogni mese.

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'ora in cui eseguire lo 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

Il minuto in cui eseguire lo 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

I mesi in cui eseguire lo 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

Indica se eseguire lo script in mesi specifici.

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 cartella in cui archiviare questa pianificazione. Serve solo a scopo visivo.

Type: String
Parameter Sets: (All)
Aliases:

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

-Cookies

Riutilizza e mantiene i cookie di autenticazione per la sessione PowerShell corrente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Workflow

Specifica il workflow di destinazione.

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

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per maggiori informazioni, consulti about_CommonParameters.

INPUT

UniversalAutomation.Script

OUTPUT

System.Object

NOTE

COLLEGAMENTI CORRELATI