Set-RDMTask

Übersicht

Eine Aufgabe speichern oder aktualisieren.

Syntax

__AllParameterSets

Set-RDMTask [-Task] <PSTask> [-Comment <string>] [-Description <string>] [-DueDate <datetime>]
 [-Force] [-Name <string>] [-Priority <int>] [-Status <string>] [-UnassignUser] [-User <Object>]
 [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Beschreibung

Speichert oder aktualisiert eine Aufgabe der aktuellen Datenquelle. 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 über die Rechte zum Hinzufügen und Bearbeiten verfügen, um die Aufgaben zu speichern. Zum Ändern von Feldern können die Parameter dieses Cmdlets verwendet werden, oder das PSTask kann direkt geändert werden. Die Bestätigungsauswirkung (ConfirmImpact) ist niedrig.

Beispiele

Beispiel 1

PS C:\> Get-RDMTask -Name ATask | Set-RDMTask -Comment "Task completed" -Status Closed

Fügt den Kommentar "Task completed" zur Aufgabe ATask hinzu und schließt sie. Wenn der Name nicht eindeutig ist, werden die Änderungen bei allen Aufgaben mit dem Namen ATask vorgenommen.

Beispiel 2

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

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

Beispiel 3

PS C:\> $user = Get-RDMUser -Name AUser; Get-RDMTask -Status Assigned -User $user | Set-RDMTask -UnassignUser

Hebt die Zuweisung aller dem Benutzer AUser zugewiesenen Aufgaben auf.

Beispiel 4

PS C:\> $task = Get-RDMTask -Name ATask; $task.Task.CustomField1 = "Whatever"; Set-RDMTask $task

Speichert die eindeutig benannte Aufgabe ATask in $task. Fügt CustomField1 einen Wert hinzu und speichert die Änderung mithilfe des einzigen positionsabhängigen Parameters.

Beispiel 5

PS C:\> Get-RDMTask -Name ATask | Set-RDMTask $task -WhatIf -Verbose -Description 'NewDesc' -DueDate 2023/1/1 -Priority 3

Mithilfe der Parameter WhatIf und Verbose kann festgestellt werden, ob die Aufgabe erstellt oder aktualisiert wird und wo genau (Datenquellenname > Eintragsname > Aufgabenname). Es werden keine Änderungen vorgenommen.

Parameter

-Comment

Ändert den Kommentar der Aufgabe.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Description

Ändert die Beschreibung der Aufgabe.

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

Gibt die Frist zur Erledigung der Aufgabe an.

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

-Force

Die Aufgabe wird ohne Bestätigung gespeichert oder erstellt.

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

-ForcePromptAnswer

Mit Vorsicht zu verwendender Schalter. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können diesem Parameter mehrere Werte übergeben werden. Hier sind die akzeptierten Werte:

• Yes: Bestätigt die Eingabeaufforderung. Deckt die Werte 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

Neuer Name für die Aufgabe.

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

-Priority

Ändert die Priorität der Aufgabe.

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

-Status

Ändert den Status der Aufgabe.

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

-Task

Hinzuzufügende oder zu ändernde Aufgabe.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSTask
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UnassignUser

Entfernt den der Aufgabe zugewiesenen Benutzer.

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

-User

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

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

-WhatIf

Zeigt, was geschehen würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- wi
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.PSTask

Die von Get-RDMTask erhaltene Aufgabe kann per Pipe an den Parameter Task übergeben werden.

Hinweise

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