Enregistrer ou mettre à jour une tâche.
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>]
Enregistrer ou mettre à jour une tâche de la source de données actuelle. Cette fonctionnalité est uniquement disponible pour les sources de données suivantes : Devolutions Server, Azure SQL, SQL Server, et SQLite. Si la source de données ne prend pas en charge les utilisateurs, le paramètre Utilisateur sera simplement ignoré. Si un dossier virtuel est impliqué, l'utilisateur doit avoir les droits d'ajout et d'édition pour enregistrer les tâches. Pour modifier des champs, ces paramètres cmdlet peuvent être utilisés ou le PSTask peut être modifié directement. L'impact de confirmation (ConfirmImpact) est faible.
PS C:\> Get-RDMTask -Name ATask | Set-RDMTask -Comment "Task completed" -Status Closed
Ajouter le commentaire "Tâche complétée" à la tâche ATask et la fermer. Si le nom n'est pas unique, toutes les tâches nommées ATask auront les modifications.
PS C:\> New-RDMTask -Name ATask -Entry AnEntry | Set-RDMTask -Force
Enregistrer une nouvelle tâche créée nommée ATask et associée à AnEntry sans demande de confirmation.
PS C:\> $user = Get-RDMUser -Name AUser; Get-RDMTask -Status Assigned -User $user | Set-RDMTask -UnassignUser
Désattribuer toutes les tâches assignées à l'utilisateur AUser.
PS C:\> $task = Get-RDMTask -Name ATask; $task.Task.CustomField1 = "Whatever"; Set-RDMTask $task
Stocker la tâche nommée de façon unique ATask dans $task. Ajouter une valeur à CustomField1 et enregistrer la modification en utilisant le seul paramètre positionnel.
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, cela permettra de déterminer si la tâche est créée ou mise à jour et où exactement (nom de la source de données > nom de l'entrée > nom de la tâche). Aucune modification n'aura lieu.
Modifier le commentaire de la tâche.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Vous demande de confirmation avant d'exécuter l'applet de commande.
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: ''
Modifier la description de la tâche.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Spécifier la date limite pour accomplir la tâche.
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: ''
La tâche sera enregistrée ou créée sans confirmation.
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: ''
Commutateur à utiliser avec précaution. Il répond automatiquement aux invites demandant oui/non, oui/non/annuler, ou ok/annuler. En cas de plusieurs invites, plusieurs valeurs peuvent être passées à ce paramètre. Voici les valeurs acceptées :
Oui : Accepter l'invite. Couvrir les valeurs OK et Automatique.
Non : Refuser l'invite oui/non/annuler. Annuler est l'option par défaut s'il n'y a pas d'option Non.
Annuler : Annuler l'invite oui/non/annuler. Non est l'option de secours s'il n'y a pas d'option Annuler.
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: ''
Nouveau nom pour la tâche.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: true
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Modifier la priorité de la tâche.
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: ''
Modifier le statut de la tâche.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Tâche à ajouter ou à modifier.
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: ''
Retirer l'utilisateur assigné à la tâche.
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: ''
Assigner cet utilisateur à la tâche. L'utilisateur peut être spécifié avec son nom, adresse courriel, ID ou un PSUserInfo.
Type: System.Object
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Montre ce qui se passerait si le cmdlet s'exécute. Le cmdlet n'est pas exécuté.
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: ''
Cette applet de commande supporte les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, voir about_CommonParameters.
La tâche obtenue à partir de Get-RDMTask peut être transmise par tube au paramètre Tâche.
Pour plus d'informations, taper "Get-Help Set-RDMTask -detailed". Pour des informations techniques, taper "Get-Help Set-RDMTask -full".