New-RDMTask

Synopsis

Créer une nouvelle tâche.

Syntaxe

__AllParameterSets

New-RDMTask [-Name] <string> [-Entry] <Object> [-Comment <string>] [-Description <string>]
 [-DueDate <datetime>] [-Priority <int>] [-SetTask] [-Status <string>] [-User <Object>]
 [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Description

Créer une nouvelle tâche. Elle doit avoir un nom et être associée à une entrée. 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 de modification pour enregistrer la tâche.

Exemples

Exemple 1

PS C:\> $task = New-RDMTask TaskName EntryName

Créer une tâche nommée TaskName et associée à l'entrée EntryName. Cette tâche n'est pas encore enregistrée, elle est donc stockée dans $task.

Exemple 2

PS C:\> New-RDMTask -Name ATask -Entry AnEntry -Description 'What To Do' -Priority 10 -User AUsername -Status Assigned -SetTask

Créer une tâche nommée ATask associée à l'entrée AnEntry. La tâche est assignée à AUsername et son statut le reflète. Elle a une priorité de 10 et une description de la tâche. Cette tâche est créée dans la source de données.

Exemple 3

PS C:\> $task = (Get-RDMPrivateSession -Name APrivateEntry | New-RDMTask -Name ATask -Comment 'For me only' -DueDate 2022/1/1)

Créer une tâche nommée ATask associée à la sous entrée privée APrivateEntry. La tâche ne se voit pas attribuée de responsable et son état indique la valeur par défaut 'Ouverte'. Sa date d'échéance correspond au premier jour de l'année 2022. Cette tâche ne se voit pas encore enregistrée, par conséquent elle se conserve dans $task.

Exemple 4

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 aucune invite de confirmation.

Exemple 5

PS C:\> $user = Get-RDMUser -Name Username; New-RDMTask -Name ATask -Entry AnEntry -User $user.Name -Status Assigned -SetTask

Enregistrer une tâche nouvellement créée nommée ATask et associée à AnEntry. La tâche est assignée à Username et son statut le reflète.

Paramètres

-Commentaire

Ajouter un commentaire à 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: ''

-Description

Ajouter la description à 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: ''

-Date d'échéance

Ajouter une date limite à l'accomplissement de 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: ''

-Entrée

Sous entrée à laquelle la tâche s'attribue. Cela peut se spécifier par ID, par nom ou par PSConnection. Les sous entrées dans le coffre privé se voient accessibles.

Type: System.Object
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ForcePromptAnswer

Commutateur à utiliser avec prudence. Il répondra automatiquement aux invites demandant oui/non, oui/non/annuler, ou ok/annuler. En cas de multiples 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 par défaut 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

Nom de la tâche.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Priorité

Définir la priorité de la tâche. La valeur par défaut se trouve être 1.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-DéfinirTâche

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

-Statut

Définir le statut de la tâche. Par défaut, le statut est Ouvert.

Type: System.String
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, son adresse courriel, son ID ou un PSUserInfo. La source de données doit prendre en charge les utilisateurs.

Type: System.Object
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

ParamètresCommuns

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

Entrées

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

L'entrée obtenue à partir de Get-RDMSession ou Get-RDMPrivateSession peut être transmise au paramètre Entry.

Remarques

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

Devolutions Forum logo Donnez-nous vos commentaires