New-RDMTask

Übersicht

Erstellt eine neue Aufgabe.

Syntax

__AllParameterSets

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

Beschreibung

Erstellt eine neue Aufgabe. Sie muss einen Namen haben und einem Eintrag zugeordnet sein. Diese Funktion ist nur für die folgenden Datenquellen verfügbar: Devolutions Server, Azure SQL, SQL Server und SQLite. Wenn die Datenquelle keine Benutzer unterstützt, wird der Parameter User einfach ignoriert. Wenn ein virtueller Ordner beteiligt ist, muss der Benutzer die Rechte zum Hinzufügen und Bearbeiten besitzen, um die Aufgabe zu speichern.

Beispiele

Beispiel 1

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

Erstellt eine Aufgabe mit dem Namen TaskName, die dem Eintrag EntryName zugeordnet ist. Diese Aufgabe ist noch nicht gespeichert, daher wird sie in $task gespeichert.

Beispiel 2

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

Erstellt eine Aufgabe mit dem Namen ATask, die dem Eintrag AnEntry zugeordnet ist. Die Aufgabe ist AUsername zugewiesen und ihr Status spiegelt dies wider. Sie hat eine Priorität von 10 und eine Beschreibung der Aufgabe. Diese Aufgabe wird in der Datenquelle erstellt.

Beispiel 3

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

Erstellt eine Aufgabe mit dem Namen ATask, die dem privaten Eintrag APrivateEntry zugeordnet ist. Die Aufgabe ist nicht zugewiesen und ihr Status hat den Standardwert 'Open'. Ihr Fälligkeitsdatum ist der erste Tag des Jahres 2022. Diese Aufgabe ist noch nicht gespeichert, daher wird sie in $task gespeichert.

Beispiel 4

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

Speichert eine neu erstellte Aufgabe mit dem Namen ATask, die AnEntry zugeordnet ist, ohne Bestätigungsaufforderung.

Beispiel 5

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

Speichert eine neu erstellte Aufgabe mit dem Namen ATask, die AnEntry zugeordnet ist. Die Aufgabe ist Username zugewiesen und ihr Status spiegelt dies wider.

Parameter

-Comment

Fügt der Aufgabe einen Kommentar hinzu.

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

Fügt der Aufgabe die Beschreibung hinzu.

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

Fügt eine Frist zur Erledigung der Aufgabe hinzu.

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

Eintrag, dem die Aufgabe zugewiesen ist. Er kann per ID, per Name oder per PSConnection angegeben werden. Einträge im privaten Tresor sind zugänglich.

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

Schalter, der mit Vorsicht zu verwenden ist. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die zulässigen Werte:

• Yes: Nimmt die Eingabeaufforderung an. Deckt den Wert OK und Automatic ab.
• No: Lehnt die Ja/Nein/Abbrechen-Eingabeaufforderung ab. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist.
• Cancel: Bricht die Ja/Nein/Abbrechen-Eingabeaufforderung ab. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist.

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

Name der Aufgabe.

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

Legt die Priorität der Aufgabe fest. Der Standardwert ist 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

Speichert die Aufgabe.

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

Legt den Status der Aufgabe fest. Standardmäßig ist der Status 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

Weist diesen Benutzer der Aufgabe zu. Der Benutzer kann mit seinem Namen, seiner E-Mail-Adresse, seiner ID oder einem PSUserInfo angegeben werden. Die Datenquelle muss Benutzer unterstützen.

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

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

Der mit Get-RDMSession oder Get-RDMPrivateSession erhaltene Eintrag kann per Pipe an den Parameter Entry übergeben werden.

Hinweise

Für weitere Informationen geben Sie "Get-Help New-RDMTask -detailed" ein. Für technische Informationen geben Sie "Get-Help New-RDMTask -full" ein.