> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/da/powershell-kommandoer/new-psuschedule.md).

# New-PSUSchedule

New-PSUSchedule opretter en tidsplan i PowerShell Universal, der kører scripts eller arbejdsflows på cron-, kontinuerlig, engangs- eller kalenderbasis.

## Synopsis

Opretter en tidsplan for scripts eller arbejdsflows.

## Syntaks

Vælg enten `-Script <Script[]>` (alias `-Scripts`; accepterer pipelineinput) eller `-Workflow <Workflow>`, og én form for tidsangivelse:

```powershell
New-PSUSchedule -Script <Script[]> -Cron <String> [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -Cron <String> [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> -Continuous [-Delay <TimeSpan>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -Continuous [-Delay <TimeSpan>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> [-OneTime <DateTime>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> [-OneTime <DateTime>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> -EveryHour [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -EveryHour [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> -EveryDay [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -EveryDay [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> -DayOfWeek -Day <String[]> [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -DayOfWeek -Day <String[]> [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> -EveryMonth -DayOfMonth <Int32> [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -EveryMonth -DayOfMonth <Int32> [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Script <Script[]> -SpecificMonth -Month <String[]> -DayOfMonth <Int32> [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
New-PSUSchedule -Workflow <Workflow> -SpecificMonth -Month <String[]> -DayOfMonth <Int32> [-Hour <Int32>] [-Minute <Int32>] [<ScheduleOptions>] [<ConnectionOptions>]
```

`<ScheduleOptions>`: `[-Name <String>] [-Description <String>] [-Credential <Variable>] [-TimeZone <String>] [-Environment <String>] [-Paused] [-RandomDelay] [-RandomDelayMaximum <Int32>] [-Timeout <Int32>] [-Condition <ScriptBlock>] [-Computer <String>] [-Parameters <Hashtable>] [-AvailableInBranch <String[]>] [-Folder <String>]`. Kontinuerlige tidsplaner accepterer også `[-DelaySecond <Int32>] [-DelayMinute <Int32>] [-DelayHour <Int32>]` som alternativer til `-Delay`. `<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`.

## Beskrivelse

Planlægger et eller flere scripts eller et arbejdsflow. Vælg en tidsstyringstilstand: cron-udtryk, kontinuerlig med valgfri forsinkelse, dato for engangskørsel, hver time, dagligt, ugentligt, månedligt eller bestemte måneder. `-Parameters` leverer værdier til målet, herunder engangsscripts uden en deklareret `param`-blok. Med ét script kan deklarerede scriptparametre også angives dynamisk; brug `-Parameters`, hvis det dynamiske opslag mislykkes. Her er `-Credential` en PSU-legitimationsoplysningsvariabel til den planlagte kørsel, ikke en legitimationsoplysning til Management API.

## Eksempler

```powershell
New-PSUSchedule -Name 'Nightly Cleanup' -Script 'Cleanup.ps1' -Cron '0 0 * * *' -Parameters @{ RetentionDays = 30 }
New-PSUSchedule -Name 'Deploy workflow' -Workflow 'Deploy' -OneTime (Get-Date).AddHours(1) -Parameters @{ Environment = 'Test' }
```

## Parametre

| Parameter                                    | Beskrivelse                                                                                                 |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `-Script`                                    | Scriptmål, alias `-Scripts`; accepterer pipelineinput.                                                      |
| `-Workflow`                                  | Arbejdsflow som mål (i stedet for scripts).                                                                 |
| `-Cron`                                      | Cron-udtryk til cron-timingformularen.                                                                      |
| `-Continuous`                                | Kører gentagne gange; angiv eventuelt en forsinkelse mellem kørsler.                                        |
| `-Delay`                                     | `TimeSpan` mellem kørsler for kontinuerlige tidsplaner.                                                     |
| `-DelaySecond`, `-DelayMinute`, `-DelayHour` | Alternative fortløbende forsinkelser i sekunder, minutter eller timer (hver angiver den samme forsinkelse). |
| `-OneTime`                                   | Dato og klokkeslæt til kørsel én gang.                                                                      |
| `-EveryHour`                                 | Kører hver time; `-Minute` vælger minuttet.                                                                 |
| `-EveryDay`                                  | Kører dagligt; `-Hour` og `-Minute` vælger tidspunktet.                                                     |
| `-DayOfWeek`, `-Day`                         | Kører på angivne ugedage; `-Day` er påkrævet med denne timingtilstand.                                      |
| `-EveryMonth`, `-DayOfMonth`                 | Kører månedligt på en påkrævet dag i måneden.                                                               |
| `-SpecificMonth`, `-Month`                   | Kører kun i angivne måneder; `-Month` og `-DayOfMonth` er påkrævede.                                        |
| `-Hour`, `-Minute`                           | Time og minut for kalenderbaserede timingtilstande.                                                         |
| `-Name`                                      | Navn på genanvendelig tidsplan.                                                                             |
| `-Description`                               | Beskrivelse af tidsplanen.                                                                                  |
| `-Credential`                                | PSU-legitimationsoplysningsvariabel til udførelse.                                                          |
| `-TimeZone`                                  | Tidszone for tidsplanen (standard er systemets tidszone).                                                   |
| `-Environment`                               | Kørselsmiljø for målet.                                                                                     |
| `-Paused`                                    | Opretter en tidsplan, der er sat på pause.                                                                  |
| `-RandomDelay`                               | Tilføjer en tilfældig forsinkelse.                                                                          |
| `-RandomDelayMaximum`                        | Maksimal tilfældig forsinkelse (standard 60).                                                               |
| `-Timeout`                                   | Timeout for planlagt kørsel.                                                                                |
| `-Condition`                                 | Scriptblokbetingelse for kørsel.                                                                            |
| `-Computer`                                  | Udførelsescomputer eller -gruppe, ikke URL'en til administrationsserveren.                                  |
| `-Parameters`                                | Hashtable med parameterværdier for målet.                                                                   |
| `-AvailableInBranch`                         | Grene, hvori tidsplanen er tilgængelig.                                                                     |
| `-Folder`                                    | Mappe for tidsplanen.                                                                                       |
| `-ComputerName`                              | URL eller værtsnavn for mål-PSU-administrations-API'en (alias `-Uri`).                                      |
| `-AppToken`                                  | App-token til Management API.                                                                               |
| `-UseDefaultCredentials`                     | Bruger de aktuelle Windows-legitimationsoplysninger.                                                        |
| `-Integrated`                                | Bruger den integrerede administrationsklient i processen.                                                   |
| `-TrustCertificate`                          | Ignorerer fejl ved certifikatvalidering.                                                                    |
| `-Cookies`                                   | Genbruger sessionscookies til godkendelse.                                                                  |

## Tilladelser

Adgangstokenet kræver `automation.schedules/create` for at køre denne cmdlet eksternt.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/da/powershell-kommandoer/new-psuschedule.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.