> 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/de/powershell-commands/invoke-rdmusercleanup.md).

# Invoke-RDMUserCleanup

Invoke-RDMUserCleanup deaktiviert oder löscht Remote Desktop Manager-Benutzer, die nicht mehr zu ihrem Identitätsanbieter passen, in der Regel die von Sync-RDMUser gemeldeten.

### Übersicht

Benutzer deaktivieren oder löschen, die nicht mehr zu ihrem Identitätsanbieter passen.

### Syntax

#### \_\_AllParameterSets

```
Invoke-RDMUserCleanup [-InputObject] <PSUserSyncResult[]> -CleanupOption <UserCleanupOption>
 [-UnassignLicenses] [-TransferUserVaultToSharedVault] [-ForcePromptAnswer <DialogResult[]>]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```

### Beschreibung

Benutzer deaktivieren oder löschen, die nicht mehr zu ihrem Identitätsanbieter passen, normalerweise die von Sync-RDMUser gemeldeten. Jeder über die Pipeline übergebene Benutzer erhält dieselbe CleanupOption, das Cmdlet also einmal je Option ausführen, um eine Mischung anzuwenden. Benutzer, die nicht in der Pipeline sind, bleiben unberührt. Gelöschte Benutzer werden in die Liste der gelöschten Benutzer verschoben und nicht endgültig entfernt. Erfordert eine Devolutions Server-Datenquelle.

### Beispiele

#### Beispiel 1

```powershell
PS C:\> Sync-RDMUser -Provider Domain | Invoke-RDMUserCleanup -CleanupOption Disable -UnassignLicenses
```

Jeden Benutzer deaktivieren, den die Domäne nicht abgleichen konnte, und die von ihm gehaltenen Lizenzen freigeben.

#### Beispiel 2

```powershell
PS C:\> $flagged = Sync-RDMUser -Provider Domain
PS C:\> $flagged | Where-Object Reason -eq 'Disabled' | Invoke-RDMUserCleanup -CleanupOption Disable
PS C:\> $flagged | Where-Object Reason -eq 'NotFound' | Invoke-RDMUserCleanup -CleanupOption Delete -TransferUserVaultToSharedVault
```

Für jede Gruppe eine andere Option anwenden und den Inhalt der privaten Tresore der gelöschten Benutzer beibehalten.

### Parameter

#### -CleanupOption

Die Aktion für jeden über die Pipeline übergebenen Benutzer. Um einen Benutzer unverändert zu lassen, ihn aus der Pipeline heraushalten.

```yaml
Type: Devolutions.RemoteDesktopManager.UserCleanupOption
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

#### -Confirm

Fordert vor der Ausführung des Cmdlets eine Bestätigung an.

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

#### -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 mehrere Werte an diesen Parameter übergeben werden. Hier sind die zulässigen Werte:

* Yes: Die Eingabeaufforderung annehmen. Deckt die Werte OK und Automatic ab.
* No: Die Ja/Nein/Abbrechen-Eingabeaufforderung ablehnen. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist.
* Cancel: Die Ja/Nein/Abbrechen-Eingabeaufforderung abbrechen. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist.

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

#### -InputObject

Gibt die zu bereinigenden Benutzer an. Benutzer müssen von Sync-RDMUser gemeldet worden sein.

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

#### -TransferUserVaultToSharedVault

Den Inhalt der privaten Tresore der gelöschten Benutzer in einen neuen freigegebenen Tresor verschieben. Gilt nur für die Option Delete.

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

#### -UnassignLicenses

Die Lizenzen der deaktivierten Benutzer freigeben. Gilt nur für die Option Disable.

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

#### -WhatIf

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

```yaml
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](https://go.microsoft.com/fwlink/?LinkID=113216).

### Eingaben

#### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserSyncResult\[]

Von Sync-RDMUser gemeldete Benutzer

### Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Invoke-RDMUserCleanup -detailed". Technische Informationen erhalten Sie mit "Get-Help Invoke-RDMUserCleanup -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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell/de/powershell-commands/invoke-rdmusercleanup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.