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

Exemples

Exemple 1

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.

Exemple 2

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.

Exemple 3

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.

Exemple 4

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.

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

Paramètres

-Commentaire

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

-Confirmer

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

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

-DateD'échéance

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

-Forcer

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

-ForcerRéponseInvitation

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

-Nom

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

-Priorité

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

-Statut

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

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

-DésattribuerUtilisateur

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

-Utilisateur

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

-WhatIf

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

CommonParameters

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.

Entrées

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSTask

La tâche obtenue à partir de Get-RDMTask peut être transmise par tube au paramètre Tâche.

Notes

Pour plus d'informations, taper "Get-Help Set-RDMTask -detailed". Pour des informations techniques, taper "Get-Help Set-RDMTask -full".

Devolutions Forum logo Donnez-nous vos commentaires