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

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

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

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

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.

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

-DueDate

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

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

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

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.

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.

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.

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.

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.

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.

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