Set-RDMTask
Synopsis
Enregistrer ou mettre à jour une tâche.
Syntaxe
__AllParameterSets
Set-RDMTask [-Task] <PSTask> [-Comment <string>] [-Description <string>] [-DueDate <datetime>]
[-Force] [-Name <string>] [-Priority <int>] [-Status <string>] [-UnassignUser] [-User <Object>]
[-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]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
PS C:\> Get-RDMTask -Name ATask | Set-RDMTask -Comment "Task completed" -Status ClosedAjouter 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
Enregistrer une tâche nouvellement créée nommée ATask et associée à AnEntry sans aucune invite de confirmation.
Exemple 3
Désassigner toutes les tâches assignées à l'utilisateur AUser.
Exemple 4
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
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.
-Confirm
Vous demande une confirmation avant d'exécuter l'applet de commande.
-Description
Modifier la description de la tâche.
-DueDate
Spécifier l'échéance pour accomplir la tâche.
-Force
La tâche sera enregistrée ou créée sans confirmation.
-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 ».
-Name
Nouveau nom pour la tâche.
-Priority
Modifier la priorité de la tâche.
-Status
Modifier le statut de la tâche.
-Task
Tâche à ajouter ou à modifier.
-UnassignUser
Retirer l'utilisateur assigné à la tâche.
-User
Assigner cet utilisateur à la tâche. L'utilisateur peut être spécifié avec son nom, son adresse courriel, son ID ou un PSUserInfo.
-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.
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.
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 ».
Mis à jour
Ce contenu vous a-t-il été utile ?