> 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/es/powershell-commands/new-rdmtask.md).

# New-RDMTask

### Sinopsis

Crear una nueva tarea.

### Sintaxis

#### \_\_AllParameterSets

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

### Descripción

Crear una nueva tarea. Debe tener un nombre y estar asociada a una entrada. Esta función solo está disponible para los siguientes espacios de trabajo: Devolutions Server, Azure SQL, SQL Server y SQLite. Si el espacio de trabajo no admite usuarios, el parámetro User simplemente se ignorará. Si hay una carpeta virtual implicada, el usuario debe tener los derechos de añadir y editar para guardar la tarea.

### Ejemplos

#### Ejemplo 1

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

Crea una tarea llamada TaskName y asociada con la entrada EntryName. Esta tarea aún no está guardada, por lo que se almacena en $task.

#### Ejemplo 2

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

Crea una tarea llamada ATask asociada con la entrada AnEntry. La tarea se asigna a AUsername y su estado lo refleja. Tiene una prioridad de 10 y una descripción de la tarea. Esta tarea se crea en el espacio de trabajo.

#### Ejemplo 3

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

Crea una tarea llamada ATask asociada con la entrada privada APrivateEntry. La tarea no está asignada y su estado es el valor predeterminado 'Open'. Su fecha de vencimiento es el primer día del año 2022. Esta tarea aún no está guardada, por lo que se almacena en $task.

#### Ejemplo 4

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

Guarda una tarea recién creada llamada ATask y asociada con AnEntry sin ninguna solicitud de confirmación.

#### Ejemplo 5

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

Guarda una tarea recién creada llamada ATask y asociada con AnEntry. La tarea se asigna a Username y su estado lo refleja.

### Parámetros

#### -Comment

Añadir un comentario a la tarea.

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

Añadir la descripción a la tarea.

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

Añadir un plazo para completar la tarea.

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

Entrada a la que se asigna la tarea. Se puede especificar por ID, por nombre o por PSConnection. Las entradas de la bóveda privada son accesibles.

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

Modificador que debe usarse con precaución. Responderá automáticamente a las solicitudes que planteen preguntas de sí/no, sí/no/cancelar u ok/cancelar. En caso de múltiples solicitudes, se pueden pasar varios valores a este parámetro. Estos son los valores aceptados:

* Yes: acepta la solicitud. Cubre los valores OK y Automatic.
* No: rechaza la solicitud sí/no/cancelar. "Cancel" es la opción alternativa si no existe la opción "No".
* Cancel: cancela la solicitud sí/no/cancelar. "No" es la opción alternativa si no existe la opción "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

Nombre de la tarea.

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

Establecer la prioridad de la tarea. El valor predeterminado es 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

Guardar la tarea.

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

Establecer el estado de la tarea. Por defecto, el estado es 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

Asignar este usuario a la tarea. El usuario puede especificarse con su nombre, su dirección de correo electrónico, su ID o un PSUserInfo. El espacio de trabajo debe admitir usuarios.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Entradas

#### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

La entrada obtenida de Get-RDMSession o Get-RDMPrivateSession se puede canalizar al parámetro Entry.

### Notas

Para más información, escriba "Get-Help New-RDMTask -detailed". Para información técnica, escriba "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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.