> 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 ### 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 impliqué, l'utilisateur doit disposer des droits d'ajout et de modification pour enregistrer les tâches. Pour modifier des champs, les paramètres de cette cmdlet 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 ``` Ajoute le commentaire « Task completed » à la tâche ATask et la ferme. Si le nom n'est pas unique, toutes les tâches nommées ATask recevront les modifications. #### Exemple 2 ```powershell PS C:\> New-RDMTask -Name ATask -Entry AnEntry | Set-RDMTask -Force ``` Enregistre 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ésassigne 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 ``` Stocke la tâche portant le nom unique ATask dans $task. Ajoute une valeur au CustomField1 et enregistre 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 à quel endroit précisément (nom de l'espace de travail > nom de l'entrée > nom de la tâche). Aucune modification ne sera effectuée. ### 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 invite à confirmer avant d'exécuter la cmdlet. ```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 la date limite 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 Paramètre à utiliser avec précaution. Il répondra automatiquement aux invites demandant des questions oui/non, oui/non/annuler ou ok/annuler. En cas de plusieurs invites, plusieurs valeurs peuvent être transmises à 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 secours s'il n'y a pas d'option « No ». * Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de secours 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é par 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 Affiche ce qui se passerait si la cmdlet s'exécutait. La cmdlet 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 cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, voir [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Entrées #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSTask La tâche obtenue à partir de Get-RDMTask peut être transmise par pipeline au 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: ``` GET https://docs.devolutions.net/powershell/fr/powershell-commands/set-rdmtask.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.