> 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/de/powershell-befehle/set-psuschedule.md). # Set-PSUSchedule Set-PSUSchedule aktualisiert einen bestehenden Zeitplan in PowerShell Universal und ändert dessen Cron-Ausdruck, Skript, Workflow, Timeout oder andere Ausführungseinstellungen. ## ÜBERSICHT Aktualisiert einen Zeitplan. ## SYNTAX ### Schedule (Standard) ``` Set-PSUSchedule [-Schedule] [[-Cron] ] [-Description ] [[-Script] ] [-Workflow ] [-TimeZone ] [-Continuous ] [-Delay ] [-Credential ] [-OneTime ] [-Environment ] [-Parameters ] [-Name ] [-Paused ] [-Timeout ] [-Condition ] [-RandomDelay ] [-Computer ] [-RandomDelayMaximum ] [-AvailableInBranch ] [-Module ] [-EveryHour ] [-Minute ] [-EveryDay ] [-Hour ] [-DayOfWeek ] [-Day ] [-EveryMonth ] [-DayOfMonth ] [-SpecificMonth ] [-Month ] [-ComputerGroup ] [-ComputerGroupInvocationType ] [-Folder ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Id ``` Set-PSUSchedule [-Id] [[-Cron] ] [-Description ] [[-Script] ] [-Workflow ] [-TimeZone ] [-Continuous ] [-Delay ] [-Credential ] [-OneTime ] [-Environment ] [-Parameters ] [-Name ] [-Paused ] [-Timeout ] [-Condition ] [-RandomDelay ] [-Computer ] [-RandomDelayMaximum ] [-AvailableInBranch ] [-Module ] [-EveryHour ] [-Minute ] [-EveryDay ] [-Hour ] [-DayOfWeek ] [-Day ] [-EveryMonth ] [-DayOfMonth ] [-SpecificMonth ] [-Month ] [-ComputerGroup ] [-ComputerGroupInvocationType ] [-Folder ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## BESCHREIBUNG Aktualisiert die Konfiguration eines bestehenden Zeitplans anhand der Id oder durch Übergabe eines Zeitplanobjekts über die Pipeline. ## BEISPIELE ### Beispiel 1 ```powershell PS C:\> Set-PSUSchedule -Id 12 -Name "Nightly Cleanup" -Cron "0 0 * * *" ``` Aktualisiert Zeitplan 12, sodass ein nächtlicher CRON-Ausdruck verwendet wird. ## PARAMETER ### -AppToken Gibt das App-Token an, das bei der Authentifizierung an der PowerShell Universal-Verwaltungs-API verwendet werden soll. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Computer Gibt den Zielcomputer an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Gibt die URL oder den Hostnamen der PowerShell Universal-Zielinstanz an. Reine Hostnamen werden zu einer `http://:5000`-URL normalisiert. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Condition Gibt eine Bedingung an, die erfolgreich ausgewertet werden muss, bevor die Ressource ausgeführt wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Continuous Führt den Zeitplan fortlaufend aus, anstatt einen festen Kalenderausdruck zu verwenden. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Anmeldeinformationen für die Anmeldung an der PowerShell Universal-Verwaltungs-API. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cron Gibt den CRON-Ausdruck für den Zeitplan an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 2 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Delay Gibt die Verzögerung zwischen den Ausführungen an. ```yaml Type: TimeSpan Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Gibt eine Beschreibung für die Ressource an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Environment Gibt die zu verwendende Ausführungsumgebung an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Id Gibt die numerische Id der Ressource an. ```yaml Type: Int64 Parameter Sets: Id Aliases: Required: True Position: 0 Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -Integrated Verwendet den prozessinternen integrierten Verwaltungsclient, wenn das Cmdlet innerhalb von PowerShell Universal ausgeführt wird. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Gibt den Namen der Ressource an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -OneTime Plant die einmalige Ausführung der Ressource zum angegebenen Datum und zur angegebenen Uhrzeit. ```yaml Type: DateTime Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Parameters Gibt Parameterwerte an, die bei der Ausführung an die Ressource übergeben werden. ```yaml Type: System.Collections.Generic.List`1[PowerShellUniversal.ScheduleParameter] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Paused Erstellt oder aktualisiert den Zeitplan in einem pausierten Zustand. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RandomDelay Fügt vor der Ausführung des Zeitplans eine zufällige Verzögerung hinzu. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RandomDelayMaximum Gibt die maximale zufällige Verzögerung in Sekunden an. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Schedule Gibt den Zielzeitplan an. ```yaml Type: Schedule Parameter Sets: Schedule Aliases: Required: True Position: 0 Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -Script Gibt das Zielskript an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 1 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TimeZone Gibt die Zeitzone an, die bei der Interpretation der Zeitplanzeiten verwendet wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Timeout Gibt das Timeout für den Vorgang in Sekunden an. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Verwendet die aktuellen Windows-Anmeldeinformationen bei der Authentifizierung an der Verwaltungs-API. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AvailableInBranch Gibt die Git-Branches an, in denen die Ressource verfügbar ist. ```yaml Type: System.Collections.Generic.List`1[System.String] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerGroup Gibt die Computergruppe an, auf die abgezielt oder der zugewiesen werden soll. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerGroupInvocationType Gibt an, wie Aufträge über die ausgewählte Computergruppe hinweg aufgerufen werden. ```yaml Type: ComputerGroupInvocationType Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Verwendet Authentifizierungscookies für die aktuelle PowerShell-Sitzung erneut und speichert sie dauerhaft. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Day Gibt die Wochentage an, an denen der Zeitplan ausgeführt werden soll. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DayOfMonth Gibt den Tag des Monats an, an dem der Zeitplan ausgeführt werden soll. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DayOfWeek Plant die Ausführung an bestimmten Wochentagen. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -EveryDay Plant die tägliche Ausführung. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -EveryHour Plant die stündliche Ausführung. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -EveryMonth Plant die monatliche Ausführung. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Folder Gibt den Zielordner an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Hour Gibt die Stundenkomponente des Zeitplans an. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Minute Gibt die Minutenkomponente des Zeitplans an. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Module Gibt den zu verwendenden PowerShell-Modulnamen an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Month Gibt die Monate an, in denen der Zeitplan ausgeführt werden soll. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SpecificMonth Plant die Ausführung nur während der durch Month angegebenen Monate. ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Erlaubt Verbindungen zu Servern mit nicht vertrauenswürdigen TLS-Zertifikaten. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Workflow Gibt den Ziel-Workflow an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## EINGABEN ### PowerShellUniversal.Schedule ## AUSGABEN ### System.Object ## HINWEISE ## VERWANDTE LINKS ## ÜBERSICHT Aktualisiert einen bestehenden Zeitplan. ## BESCHREIBUNG Aktualisiert einen Zeitplan anhand der ID oder eines Zeitplanobjekts. Zeitpläne können über `-Script` auf ein oder mehrere Skripte oder über `-Workflow` auf einen Workflow abzielen. Verwenden Sie `-OneTime` für eine einmalige Ausführung und `-Parameters` für Zielparameter. Wiederverwendbare Zeitplandefinitionen können aktualisiert werden, ohne sie neu zu erstellen. ## BEISPIEL ```powershell Set-PSUSchedule -Id 12 -Workflow 'Deploy' -OneTime (Get-Date).AddHours(1) -Parameters @{ Environment = 'Test' } ``` ## PARAMETER * **Script**: Skriptziele; akzeptiert mehrere Werte. * **Workflow**: Workflow-Ziel. * **OneTime**: Datum und Uhrzeit der einmaligen Ausführung. * **Parameters**: Werte, die bei der Ausführung an das Ziel übergeben werden. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/de/powershell-befehle/set-psuschedule.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.