> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell/fr/powershell-commands/new-rdmtask.md).

# 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 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 la tâche.

### Exemples

#### Exemple 1

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

```powershell
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 l'espace de travail.

#### Exemple 3

```powershell
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 à l'entrée privée APrivateEntry. La tâche n'est pas assignée et son statut correspond à la valeur par défaut « Open ». Sa date d'échéance est le premier jour de l'année 2022. Cette tâche n'est pas encore enregistrée ; elle est donc stockée dans $task.

#### Exemple 4

```powershell
PS C:\> New-RDMTask -Name ATask -Entry AnEntry | Set-RDMTask -Force
```

Enregistrer une nouvelle tâche nommée ATask et associée à AnEntry sans aucune invite de confirmation.

#### Exemple 5

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

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

### Paramètres

#### -Comment

Ajouter un commentaire à la tâche.

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

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

Ajouter une date limite pour accomplir la tâche.

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

#### -Entry

Entrée à laquelle la tâche est assignée. Elle peut être spécifiée par ID, par nom ou par PSConnection. Les entrées dans le coffre privé sont accessibles.

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

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 d'invites multiples, 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 repli s'il n'existe pas d'option « No ».
* Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de repli s'il n'existe pas d'option « Cancel ».

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

Nom de la tâche.

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

#### -Priority

Définir la priorité de la tâche. La valeur par défaut est 1.

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

#### -SetTask

Enregistrer la tâche.

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

#### -Status

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

```yaml
Type: System.String
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. L'espace de travail doit prendre en charge les utilisateurs.

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

#### CommonParameters

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, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Entrées

#### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

L'entrée obtenue depuis Get-RDMSession ou Get-RDMPrivateSession peut être transmise par pipeline au paramètre Entry.

### Notes

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devolutions.net/powershell/fr/powershell-commands/new-rdmtask.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
