> 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/add-rdmroleassignment.md).

# Add-RDMRoleAssignment

Add-RDMRoleAssignment gewährt einem oder mehreren Benutzern, Benutzergruppen oder Anwendungsidentitäten eine administrative Rolle in einem oder mehreren Bereichen in Remote Desktop Manager.

### Übersicht

Eine administrative Rolle Benutzern, Benutzergruppen oder Anwendungsidentitäten zuweisen.

### Syntax

#### \_\_AllParameterSets

```
Add-RDMRoleAssignment [-Role] <PSAdministrativeRole> [-User <PSUserInfo[]>] [-UserGroup <PSRoleInfo[]>]
 [-ApplicationIdentity <PSApplicationIdentityInfo[]>] -ScopeType <AdministrativeRoleAssignmentScopeType>
 [-ScopeID <guid[]>] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
```

### Beschreibung

Eine administrative Rolle Benutzern, Benutzergruppen oder Anwendungsidentitäten in einem oder mehreren Bereichen gewähren. Anders als Add-RDMUserVaultAccess, das auf einem Tresor immer die in der Datenquelle konfigurierte Tresorzuweisungsrolle gewährt, weist dies jede Rolle in jedem Bereich zu, den die Rolle unterstützt.

### Beispiele

#### Beispiel 1

```powershell
PS C:\> $role = Get-RDMAdministrativeRole -Name "Vault Owner"
PS C:\> $vault = Get-RDMVault -Name "Production"
PS C:\> Add-RDMRoleAssignment -Role $role -User (Get-RDMUser -Name "jsmith") -ScopeType Repository -ScopeID $vault.ID
```

Gewährt die Rolle 'Tresorbesitzer' einem Benutzer für einen bestimmten Tresor.

#### Beispiel 2

```powershell
PS C:\> Add-RDMRoleAssignment -Role $role -ApplicationIdentity (Get-RDMApplicationIdentity -Name "MyServiceApp") -ScopeType Global
```

Gewährt einer Anwendungsidentität eine Rolle in der gesamten Datenquelle.

#### Beispiel 3

```powershell
PS C:\> Get-RDMAdministrativeRole -ScopeType Repository | Add-RDMRoleAssignment -UserGroup $groups -ScopeType Repository -ScopeID $vault1.ID, $vault2.ID
```

Gewährt jede einem Tresor zuweisbare Rolle mehreren Benutzergruppen für zwei Tresore.

### Parameter

#### -ApplicationIdentity

Anwendungsidentitäten, die die Rolle erhalten

```yaml
Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSApplicationIdentityInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  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: ''
```

#### -Role

Zuzuweisende administrative Rolle

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

#### -ScopeID

IDs der Bereichsressourcen, denen die Rolle zugewiesen wird: Tresor-IDs, wenn -ScopeType Repository ist, Gateway-IDs, wenn Gateway, PAM-Anbieter-IDs, wenn PamProvider, oder Geschäftseinheits-IDs, wenn OrganizationalUnit. Erforderlich, außer wenn -ScopeType Global ist

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

#### -ScopeType

Bereichstyp der Zuweisung. Es gibt keinen Standardwert, damit eine Rolle niemals still im falschen Bereich zugewiesen wird

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

#### -User

Benutzer, die die Rolle erhalten

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

#### -UserGroup

Benutzergruppen, die die Rolle erhalten

```yaml
Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSRoleInfo[]
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.PSAdministrativeRole

Zuzuweisende administrative Rolle

### Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Add-RDMRoleAssignment -detailed". Technische Informationen erhalten Sie mit "Get-Help Add-RDMRoleAssignment -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/add-rdmroleassignment.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.