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

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

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

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

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

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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