> 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/new-rdmtask.md). # New-RDMTask ### Übersicht Erstellt eine neue Aufgabe. ### Syntax #### \_\_AllParameterSets ``` New-RDMTask [-Name] [-Entry] [-Comment ] [-Description ] [-DueDate ] [-Priority ] [-SetTask] [-Status ] [-User ] [-ForcePromptAnswer ] [] ``` ### Beschreibung Erstellt eine neue Aufgabe. Sie muss einen Namen haben und einem Eintrag zugeordnet sein. 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 die Rechte zum Hinzufügen und Bearbeiten besitzen, um die Aufgabe zu speichern. ### Beispiele #### Beispiel 1 ```powershell PS C:\> $task = New-RDMTask TaskName EntryName ``` Erstellt eine Aufgabe mit dem Namen TaskName, die dem Eintrag EntryName zugeordnet ist. Diese Aufgabe ist noch nicht gespeichert, daher wird sie in $task gespeichert. #### Beispiel 2 ```powershell PS C:\> New-RDMTask -Name ATask -Entry AnEntry -Description 'What To Do' -Priority 10 -User AUsername -Status Assigned -SetTask ``` Erstellt eine Aufgabe mit dem Namen ATask, die dem Eintrag AnEntry zugeordnet ist. Die Aufgabe ist AUsername zugewiesen und ihr Status spiegelt dies wider. Sie hat eine Priorität von 10 und eine Beschreibung der Aufgabe. Diese Aufgabe wird in der Datenquelle erstellt. #### Beispiel 3 ```powershell PS C:\> $task = (Get-RDMPrivateSession -Name APrivateEntry | New-RDMTask -Name ATask -Comment 'For me only' -DueDate 2022/1/1) ``` Erstellt eine Aufgabe mit dem Namen ATask, die dem privaten Eintrag APrivateEntry zugeordnet ist. Die Aufgabe ist nicht zugewiesen und ihr Status hat den Standardwert 'Open'. Ihr Fälligkeitsdatum ist der erste Tag des Jahres 2022. Diese Aufgabe ist noch nicht gespeichert, daher wird sie in $task gespeichert. #### Beispiel 4 ```powershell PS C:\> New-RDMTask -Name ATask -Entry AnEntry | Set-RDMTask -Force ``` Speichert eine neu erstellte Aufgabe mit dem Namen ATask, die AnEntry zugeordnet ist, ohne Bestätigungsaufforderung. #### Beispiel 5 ```powershell PS C:\> $user = Get-RDMUser -Name Username; New-RDMTask -Name ATask -Entry AnEntry -User $user.Name -Status Assigned -SetTask ``` Speichert eine neu erstellte Aufgabe mit dem Namen ATask, die AnEntry zugeordnet ist. Die Aufgabe ist Username zugewiesen und ihr Status spiegelt dies wider. ### Parameter #### -Comment Fügt der Aufgabe einen Kommentar hinzu. ```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: '' ``` #### -Description Fügt der Aufgabe die Beschreibung hinzu. ```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 Fügt eine Frist zur Erledigung der Aufgabe hinzu. ```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: '' ``` #### -Entry Eintrag, dem die Aufgabe zugewiesen ist. Er kann per ID, per Name oder per PSConnection angegeben werden. Einträge im privaten Tresor sind zugänglich. ```yaml Type: System.Object DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 1 IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -ForcePromptAnswer Schalter, der mit Vorsicht zu verwenden ist. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die zulässigen Werte: * Yes: Nimmt die Eingabeaufforderung an. Deckt den Wert 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 Name der Aufgabe. ```yaml Type: System.String DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Priority Legt die Priorität der Aufgabe fest. Der Standardwert ist 1. ```yaml Type: System.Int32 DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -SetTask Speichert die Aufgabe. ```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: '' ``` #### -Status Legt den Status der Aufgabe fest. Standardmäßig ist der Status Open. ```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: '' ``` #### -User Weist diesen Benutzer der Aufgabe zu. Der Benutzer kann mit seinem Namen, seiner E-Mail-Adresse, seiner ID oder einem PSUserInfo angegeben werden. Die Datenquelle muss Benutzer unterstützen. ```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: '' ``` #### 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.PSConnection Der mit Get-RDMSession oder Get-RDMPrivateSession erhaltene Eintrag kann per Pipe an den Parameter Entry übergeben werden. ### Hinweise Für weitere Informationen geben Sie "Get-Help New-RDMTask -detailed" ein. Für technische Informationen geben Sie "Get-Help New-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/new-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.