> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/phone/add-or-remove-call-queue-authorized-users.md).

# Autorisierte Benutzer der Anrufwarteschlange hinzufügen oder entfernen

Autorisierte Benutzer einer Teams-Anrufwarteschlange hinzufügen oder entfernen

### Beschreibung

Fügt die ausgewählten Benutzer zu den autorisierten Benutzern einer Anrufwarteschlange hinzu oder entfernt sie. Autorisierte Benutzer können die Warteschlangeneinstellungen in der Teams-App ändern; Microsoft erlaubt davon 15 pro Anrufwarteschlange. Die Teams-Richtlinie für Sprachanwendungen, die sie dafür benötigen, kann im selben Lauf zugewiesen oder entfernt werden. Details zu den Prüfungen und Optionen stehen in der Runbook-Dokumentation (docs.realmjoin.com).

### So funktioniert es

Die Anrufwarteschlange wird über ihren exakten Namen gesucht. Groß- und Kleinschreibung spielen keine Rolle. Wenn keine Warteschlange übereinstimmt, listet das Runbook ähnliche Namen auf, die es gefunden hat; wenn zwei Warteschlangen denselben Namen haben, bricht es ab und fordert eindeutige Namen an.

Bevor etwas geändert wird, gibt das Runbook die aktuellen autorisierten Benutzer der Warteschlange zusammen mit ihrer Richtlinie für Sprachanwendungen aus und anschließend die geplante Änderung pro ausgewähltem Benutzer. Ein Benutzer, der in Microsoft Teams nicht gefunden wird, kein reguläres Benutzerkonto ist oder nicht für Enterprise Voice aktiviert ist, wird mit der Begründung übersprungen; die restlichen Benutzer werden dennoch verarbeitet. Benutzer, die bereits autorisiert sind (beim Hinzufügen) oder überhaupt nicht autorisiert sind (beim Entfernen), werden gemeldet und unverändert gelassen.

Microsoft erlaubt 15 autorisierte Benutzer pro Anrufwarteschlange. Wenn die Auswahl die Warteschlange über dieses Limit bringen würde, bricht das Runbook vor jeder Änderung ab, statt einen Teil davon anzuwenden.

Anrufwarteschlangen führen außerdem eine Liste ausgeblendeter autorisierter Benutzer. Wenn ein autorisierter Benutzer entfernt wird, entfernt das Runbook ihn im selben Schreibvorgang auch aus dieser Liste, sodass kein Eintrag zurückbleibt.

Nach dem Schreiben wird die Anrufwarteschlange erneut gelesen und die resultierende Liste mit der erwarteten verglichen. Eine Abweichung wird als Warnung statt als Fehler gemeldet, da der Dienst die Änderung asynchron anwendet.

### Richtlinie für Sprachanwendungen

Autorisierter Benutzer zu sein ist nur die halbe Berechtigung. Um die Warteschlangeneinstellungen in der Teams-App tatsächlich zu ändern, benötigt der Benutzer außerdem eine Richtlinie für Sprachanwendungen in Teams, die die Verwaltung von Anrufwarteschlangen erlaubt. Die globale Richtlinie tut das in der Regel nicht, weshalb das Runbook darauf hinweist, wenn es einen autorisierten Benutzer hinzufügt, der keine eigene Richtlinie hat.

Das Richtlinienfeld bietet drei Optionen:

* **Die Richtlinie unverändert lassen** ändert keine Richtlinienzuweisung.
* **Eine Richtlinie für Sprachanwendungen zuweisen** gewährt die angegebene Richtlinie jedem Benutzer, der hinzugefügt wurde oder bereits autorisiert war. Die Richtlinie muss im Tenant vorhanden sein; der Name wird vor jeder Änderung geprüft. Ein Benutzer, der diese Richtlinie bereits verwendet, wird gemeldet und nicht erneut geändert.
* **Die Richtlinie für Sprachanwendungen entfernen** setzt die benutzerspezifische Zuweisung aller Benutzer zurück, die aus der Liste entfernt wurden.

Das Zuweisen einer Richtlinie wird nur zusammen mit dem Hinzufügen von Benutzern angeboten, das Entfernen nur zusammen mit dem Entfernen von Benutzern. Die beiden anderen Kombinationen werden sofort abgelehnt, da sie Berechtigungen in die entgegengesetzte Richtung der Warteschlangenänderung ändern würden.

Eine Richtlinie, die der Benutzer über eine Gruppenrichtlinienzuweisung erhält, kann nicht benutzerspezifisch entfernt werden. Das Runbook meldet stattdessen die Richtlinie und die Gruppe, damit die Zuweisung an der Quelle geändert werden kann. Wenn ein Benutzer sowohl eine direkte als auch eine Gruppen-Zuweisung hat, übernimmt nach dem Entfernen der direkten die Gruppen-Zuweisung; das sagt das Runbook in der Ausgabe auch so.

Vor dem Entfernen einer Richtlinie durchsucht das Runbook alle anderen Anrufwarteschlangen und Autoattendants nach diesem Benutzer. Wenn der Benutzer irgendwo sonst noch autorisierter Benutzer ist, wird die Richtlinie beibehalten und die betroffenen Objekte werden in einer Warnung benannt. Der Benutzer wird trotzdem aus dieser Anrufwarteschlange entfernt.

### Hinweise und Einschränkungen

Autorisierte Benutzer müssen für Enterprise Voice aktiviert sein, was in der Praxis einer Teams Phone-Lizenz entspricht. Es kann bis zu einer Stunde dauern, bis ein neu lizenzierter Benutzer in Teams PowerShell sichtbar wird; bis dahin meldet das Runbook ihn als nicht gefunden.

Begrüßungs- und Feiertagsanrufabläufe können von autorisierten Benutzern direkt im Teams-Client geändert werden. Das Ändern von Anrufrouting, Mitgliedschaft oder Ausnahmebehandlung sowie das Anzeigen von Berichten erfordert die Queues-App, die für jeden Benutzer der App eine Teams Premium-Lizenz benötigt. Das Runbook gewährt nur die Berechtigung und prüft nicht die Lizenzierung der App.

Änderungen an autorisierten Benutzern und Richtlinienzuweisungen werden vom Dienst repliziert und können einige Minuten benötigen, bis sie im Teams admin center und im Teams-Client angezeigt werden.

Ob ein autorisierter Benutzer ausgeblendet ist, wird nur beibehalten, niemals absichtlich geändert. Verwenden Sie das Teams admin center, um einen autorisierten Benutzer ein- oder auszublenden.

### Speicherort

Organisation → Telefon → Autorisierte Benutzer der Anrufwarteschlange hinzufügen oder entfernen

**Voller Runbook-Name**

rjgit-org\_phone\_add-or-remove-call-queue-authorized-users

### Details

| Eigenschaft          | Wert                                                                    |
| -------------------- | ----------------------------------------------------------------------- |
| Version              | 1.0.0                                                                   |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>MicrosoftTeams (>= 7.9.0)</p> |
| Planbar              | nein                                                                    |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Organization.Read.All
    * *Erforderlich für die app-basierte Teams PowerShell-Anmeldung (Connect-MicrosoftTeams -Identity), um Mandanteninformationen zu lesen*

#### RBAC-Rollen

* Teams-Administrator
  * *Erforderlich, um Get-CsCallQueue, Set-CsCallQueue, Get-CsAutoAttendant, Get-CsOnlineUser, Get-CsUserPolicyAssignment, Get-CsTeamsVoiceApplicationsPolicy und Grant-CsTeamsVoiceApplicationsPolicy über app-basiertes Teams PowerShell auszuführen*

### Parameter

#### CallQueueName

Exakter Name der Anrufwarteschlange, wie er im Teams admin center angezeigt wird. Groß- und Kleinschreibung spielen keine Rolle.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | wahr                        |
| Standardwert          |                             |
| Typ                   | Zeichenfolge                |
| Anzeigename im Portal | Name der Anrufwarteschlange |

#### UserIds

Benutzer, die zur Liste der autorisierten Benutzer hinzugefügt oder daraus entfernt werden. Mehrere Benutzer können gleichzeitig ausgewählt werden; jeder einzelne muss für Teams Phone aktiviert sein.

| Eigenschaft           | Wert      |
| --------------------- | --------- |
| Erforderlich          | wahr      |
| Standardwert          |           |
| Typ                   | String\[] |
| Anzeigename im Portal | Benutzer  |

#### Entfernen

Benutzer als autorisierte Benutzer hinzufügen fügt sie der Liste der autorisierten Benutzer der Warteschlange hinzu. Benutzer als autorisierte Benutzer entfernen nimmt sie wieder daraus heraus.

| Eigenschaft           | Wert     |
| --------------------- | -------- |
| Erforderlich          | falsch   |
| Standardwert          | Falsch   |
| Typ                   | Boolesch |
| Anzeigename im Portal | Aktion   |

**Portaloptionen**

| Portaloption                                  | Wert   |
| --------------------------------------------- | ------ |
| Benutzer als autorisierte Benutzer hinzufügen | falsch |
| Benutzer als autorisierte Benutzer entfernen  | wahr   |

#### VoiceApplicationsPolicyAction

Die Richtlinie unverändert lassen nimmt keine Richtlinienänderung vor. Eine Richtlinie für Sprachanwendungen zuweisen gewährt die unter "Richtlinienname" eingegebene Richtlinie. Die Richtlinie für Sprachanwendungen entfernen setzt eine benutzerspezifische Zuweisung zurück, wenn die Benutzer aus der Liste entfernt werden.

| Eigenschaft           | Wert                             |
| --------------------- | -------------------------------- |
| Erforderlich          | falsch                           |
| Standardwert          | Keine                            |
| Typ                   | Zeichenfolge                     |
| Anzeigename im Portal | Richtlinie für Sprachanwendungen |

**Portaloptionen**

| Portaloption                                   | Wert      |
| ---------------------------------------------- | --------- |
| Die Richtlinie unverändert lassen              | Keine     |
| Eine Richtlinie für Sprachanwendungen zuweisen | Zuweisen  |
| Die Richtlinie für Sprachanwendungen entfernen | Entfernen |

#### VoiceApplicationsPolicyName

Richtlinie für Sprachanwendungen, die zugewiesen werden soll, genau so benannt wie im Teams admin center. Wird nur mit "Eine Richtlinie für Sprachanwendungen zuweisen" verwendet.

| Eigenschaft           | Wert            |
| --------------------- | --------------- |
| Erforderlich          | falsch          |
| Standardwert          |                 |
| Typ                   | Zeichenfolge    |
| Anzeigename im Portal | Richtlinienname |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/runbooks/runbook-references.md)


---

# 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.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/phone/add-or-remove-call-queue-authorized-users.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.