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 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

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

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

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

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

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.

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.

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.

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.

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.

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 ».

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.

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.

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.

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.

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.

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.

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.

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.

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 ».