> 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/de/powershell-commands/set-rdmtask.md). # Set-RDMTask ### Übersicht Eine Aufgabe speichern oder aktualisieren. ### Syntax #### \_\_AllParameterSets ``` Set-RDMTask [-Task] [-Comment ] [-Description ] [-DueDate ] [-Force] [-Name ] [-Priority ] [-Status ] [-UnassignUser] [-User ] [-ForcePromptAnswer ] [-WhatIf] [-Confirm] [] ``` ### Beschreibung Speichert oder aktualisiert eine Aufgabe der aktuellen Datenquelle. Diese Funktion ist nur für die folgenden Datenquellen verfügbar: Devolutions Server, Azure SQL, SQL Server und SQLite. Wenn die Datenquelle keine Benutzer unterstützt, wird der Parameter User einfach ignoriert. Wenn ein virtueller Ordner beteiligt ist, muss der Benutzer über die Rechte zum Hinzufügen und Bearbeiten verfügen, um die Aufgaben zu speichern. Zum Ändern von Feldern können die Parameter dieses Cmdlets verwendet werden, oder das PSTask kann direkt geändert werden. Die Bestätigungsauswirkung (ConfirmImpact) ist niedrig. ### Beispiele #### Beispiel 1 ```powershell PS C:\> Get-RDMTask -Name ATask | Set-RDMTask -Comment "Task completed" -Status Closed ``` Fügt den Kommentar "Task completed" zur Aufgabe ATask hinzu und schließt sie. Wenn der Name nicht eindeutig ist, werden die Änderungen bei allen Aufgaben mit dem Namen ATask vorgenommen. #### Beispiel 2 ```powershell PS C:\> New-RDMTask -Name ATask -Entry AnEntry | Set-RDMTask -Force ``` Speichert eine neu erstellte Aufgabe mit dem Namen ATask, die mit AnEntry verknüpft ist, ohne Bestätigungsaufforderung. #### Beispiel 3 ```powershell PS C:\> $user = Get-RDMUser -Name AUser; Get-RDMTask -Status Assigned -User $user | Set-RDMTask -UnassignUser ``` Hebt die Zuweisung aller dem Benutzer AUser zugewiesenen Aufgaben auf. #### Beispiel 4 ```powershell PS C:\> $task = Get-RDMTask -Name ATask; $task.Task.CustomField1 = "Whatever"; Set-RDMTask $task ``` Speichert die eindeutig benannte Aufgabe ATask in $task. Fügt CustomField1 einen Wert hinzu und speichert die Änderung mithilfe des einzigen positionsabhängigen Parameters. #### Beispiel 5 ```powershell PS C:\> Get-RDMTask -Name ATask | Set-RDMTask $task -WhatIf -Verbose -Description 'NewDesc' -DueDate 2023/1/1 -Priority 3 ``` Mithilfe der Parameter WhatIf und Verbose kann festgestellt werden, ob die Aufgabe erstellt oder aktualisiert wird und wo genau (Datenquellenname > Eintragsname > Aufgabenname). Es werden keine Änderungen vorgenommen. ### Parameter #### -Comment Ändert den Kommentar der Aufgabe. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Confirm Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: - cf ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Description Ändert die Beschreibung der Aufgabe. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -DueDate Gibt die Frist zur Erledigung der Aufgabe an. ```yaml Type: System.Nullable`1[System.DateTime] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Force Die Aufgabe wird ohne Bestätigung gespeichert oder erstellt. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -ForcePromptAnswer Mit Vorsicht zu verwendender Schalter. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können diesem Parameter mehrere Werte übergeben werden. Hier sind die akzeptierten Werte: * Yes: Bestätigt die Eingabeaufforderung. Deckt die Werte OK und Automatic ab. * No: Lehnt die Ja/Nein/Abbrechen-Eingabeaufforderung ab. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist. * Cancel: Bricht die Ja/Nein/Abbrechen-Eingabeaufforderung ab. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist. ```yaml Type: System.Windows.Forms.DialogResult[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Name Neuer Name für die Aufgabe. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Priority Ändert die Priorität der Aufgabe. ```yaml Type: System.Nullable`1[System.Int32] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Status Ändert den Status der Aufgabe. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Task Hinzuzufügende oder zu ändernde Aufgabe. ```yaml Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSTask DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -UnassignUser Entfernt den der Aufgabe zugewiesenen Benutzer. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -User Weist diesen Benutzer der Aufgabe zu. Der Benutzer kann mit seinem Namen, seiner E-Mail-Adresse, seiner ID oder einem PSUserInfo angegeben werden. ```yaml Type: System.Object DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -WhatIf Zeigt, was geschehen würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: - wi ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### CommonParameters Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Eingaben #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSTask Die von Get-RDMTask erhaltene Aufgabe kann per Pipe an den Parameter Task übergeben werden. ### Hinweise Für weitere Informationen geben Sie "Get-Help Set-RDMTask -detailed" ein. Für technische Informationen geben Sie "Get-Help Set-RDMTask -full" ein. --- # 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/de/powershell-commands/set-rdmtask.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.