Set-RDMTask

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 l'espace de travail actuel.\u006eCette fonctionnalité n'est disponible que pour les espaces de travail suivants\u00a0: Devolutions Server, Azure SQL, SQL Server et SQLite.\u006eSi l'espace de travail ne prend pas en charge les utilisateurs, le paramètre User sera simplement ignoré.\u006eSi un dossier virtuel est impliqué, l'utilisateur doit avoir les droits d'ajout et de modification pour enregistrer les tâches.\u006ePour modifier les champs, utiliser les paramètres de cette applet de commande ou modifier directement PSTask.\u006eL'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

Utiliser les paramètres WhatIf et Verbose pour 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).\u006eAucune modification ne sera effectuée.

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 la demande oui/non/annuler. « Annuler » est l'option de secours s'il n'y a pas d'option « Non ».

• Annuler: Annuler la demande 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. Spécifier l'utilisateur 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: ''

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