> 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/fr/powershell-commands/set-rdmtask.md). # Set-RDMTask Set-RDMTask enregistre ou met à jour une tâche de Remote Desktop Manager, ce qui permet de modifier son commentaire, sa description, sa date d'échéance, sa priorité ou son statut. ### Synopsis Enregistrer ou mettre à jour une tâche. ### Syntaxe #### \_\_AllParameterSets ``` Set-RDMTask [-Task] [-Comment ] [-Description ] [-DueDate ] [-Force] [-Name ] [-Priority ] [-Status ] [-UnassignUser] [-User ] [-ForcePromptAnswer ] [-WhatIf] [-Confirm] [] ``` ### Description Enregistrer ou mettre à jour une tâche de l'espace de travail actuel. Cette fonctionnalité est uniquement disponible pour les espaces de travail suivants : Devolutions Server, Azure SQL, SQL Server et SQLite. Si l'espace de travail ne prend pas en charge les utilisateurs, le paramètre User sera simplement ignoré. Si un dossier virtuel est concerné, l'utilisateur doit avoir les droits d'ajout et de modification pour enregistrer les tâches. Pour modifier des champs, les paramètres de cette applet de commande peuvent être utilisés ou le PSTask peut être modifié directement. L'impact de confirmation (ConfirmImpact) est faible. ### Exemples #### Exemple 1 ```powershell PS C:\> Get-RDMTask -Name ATask | Set-RDMTask -Comment "Task completed" -Status Closed ``` Ajouter le commentaire « Task completed » à la tâche ATask et la fermer. Si le nom n'est pas unique, toutes les tâches nommées ATask subiront les modifications. #### Exemple 2 ```powershell PS C:\> New-RDMTask -Name ATask -Entry AnEntry | Set-RDMTask -Force ``` Enregistrer une tâche nouvellement créée nommée ATask et associée à AnEntry sans aucune invite de confirmation. #### Exemple 3 ```powershell PS C:\> $user = Get-RDMUser -Name AUser; Get-RDMTask -Status Assigned -User $user | Set-RDMTask -UnassignUser ``` Désassigner toutes les tâches assignées à l'utilisateur AUser. #### Exemple 4 ```powershell PS C:\> $task = Get-RDMTask -Name ATask; $task.Task.CustomField1 = "Whatever"; Set-RDMTask $task ``` Stocker la tâche au nom unique ATask dans $task. Ajouter une valeur au CustomField1 et enregistrer la modification en utilisant le seul paramètre positionnel. #### Exemple 5 ```powershell PS C:\> Get-RDMTask -Name ATask | Set-RDMTask $task -WhatIf -Verbose -Description 'NewDesc' -DueDate 2023/1/1 -Priority 3 ``` En utilisant les paramètres WhatIf et Verbose, il sera possible de déterminer si la tâche est créée ou mise à jour et où exactement (nom de l'espace de travail > nom de l'entrée > nom de la tâche). Aucune modification n'aura lieu. ### Paramètres #### -Comment Modifier le commentaire de la tâche. ```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 Vous demande une confirmation avant d'exécuter l'applet de commande. ```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 Modifier la description de la tâche. ```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 Spécifier l'échéance pour accomplir la tâche. ```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 La tâche sera enregistrée ou créée sans confirmation. ```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 Commutateur à utiliser avec prudence. Il répondra automatiquement aux invites posant des questions oui/non, oui/non/annuler ou ok/annuler. En cas d'invites multiples, plusieurs valeurs peuvent être passées à ce paramètre. Voici les valeurs acceptées : * Yes : Accepter l'invite. Couvre les valeurs OK et Automatic. * No : Refuser l'invite oui/non/annuler. « Cancel » est l'option de repli s'il n'y a pas d'option « No ». * Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de repli s'il n'y a pas d'option « Cancel ». ```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 Nouveau nom pour la tâche. ```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 Modifier la priorité de la tâche. ```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 Modifier le statut de la tâche. ```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 Tâche à ajouter ou à modifier. ```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 Retirer l'utilisateur assigné à la tâche. ```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 Assigner cet utilisateur à la tâche. L'utilisateur peut être spécifié avec son nom, son adresse courriel, son ID ou un PSUserInfo. ```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 Montre ce qui se produirait si l'applet de commande était exécutée. L'applet de commande n'est pas exécutée. ```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 Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Entrées #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSTask La tâche obtenue de Get-RDMTask peut être acheminée vers le paramètre Task. ### Notes Pour plus d'informations, tapez « Get-Help Set-RDMTask -detailed ». Pour des informations techniques, tapez « Get-Help Set-RDMTask -full ». --- # 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/fr/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.