> 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 den autorisierten Benutzern einer Anrufwarteschlange hinzu oder entfernt sie. Autorisierte Benutzer können die Warteschlangeneinstellungen in der Teams-App ändern; Microsoft erlaubt 15 davon pro Anrufwarteschlange. Die Teams-Voice-Applications-Richtlinie, die sie dafür benötigen, kann im selben Lauf zugewiesen oder entfernt werden. Details zu den Prüfungen und Optionen finden Sie in der Runbook-Dokumentation (docs.realmjoin.com).

### So funktioniert es

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

Bevor etwas geändert wird, gibt das Runbook die aktuellen autorisierten Benutzer der Warteschlange mit ihrer Voice-Applications-Richtlinie aus und dann die geplante Änderung pro ausgewähltem Benutzer. Ein Benutzer, der in Microsoft Teams nicht gefunden werden kann, kein reguläres Benutzerkonto ist oder nicht für Enterprise Voice aktiviert ist, wird mit dem Grund übersprungen, und die übrigen Benutzer werden weiter verarbeitet. Benutzer, die bereits autorisiert sind (beim Hinzufügen) oder überhaupt nicht autorisiert sind (beim Entfernen), werden gemeldet und bleiben unverändert.

Microsoft erlaubt 15 autorisierte Benutzer pro Anrufwarteschlange. Wenn die Auswahl die Warteschlange über dieses Limit hinaus bringen würde, stoppt das Runbook vorher, statt nur einen Teil anzuwenden.

Anrufwarteschlangen führen auch 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 Schreibvorgang 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.

### Voice-Applications-Richtlinie

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 Teams-Voice-Applications-Richtlinie, die die Verwaltung von Anrufwarteschlangen erlaubt. Die Global-Richtlinie tut das in der Regel nicht, weshalb das Runbook darauf hinweist, wenn es einen autorisierten Benutzer hinzufügt, der keine eigene Richtlinie hat.

Die Richtlinienoption bietet drei Möglichkeiten:

* **Die Richtlinie unverändert lassen** ändert keine Richtlinienzuweisung.
* **Eine Voice-Applications-Richtlinie zuweisen** gewährt jedem Benutzer, der hinzugefügt wurde oder bereits autorisiert war, die genannte Richtlinie. 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.
* **Eine Voice-Applications-Richtlinie entfernen** setzt die benutzerspezifische Zuweisung jedes Benutzers zurück, der aus der Liste entfernt wurde.

Das Zuweisen einer Richtlinie wird nur zusammen mit dem Hinzufügen von Benutzern angeboten, das Entfernen einer Richtlinie nur zusammen mit dem Entfernen von Benutzern. Die anderen beiden Kombinationen werden sofort abgelehnt, weil sie Berechtigungen in die entgegengesetzte Richtung der Warteschlangenänderung verschieben 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 Gruppenzuweisung hat, übernimmt nach dem Entfernen der direkten Zuweisung die Gruppenzuweisung; das sagt das Runbook in der Ausgabe auch so.

Bevor eine Richtlinie entfernt wird, durchsucht das Runbook alle anderen Anrufwarteschlangen und Auto Attendants nach diesem Benutzer. Wenn der Benutzer anderswo noch ein autorisierter Benutzer ist, bleibt die Richtlinie erhalten und die betroffenen Objekte werden in einer Warnung genannt. Der Benutzer wird dennoch aus dieser Anrufwarteschlange entfernt.

### Hinweise und Einschränkungen

Autorisierte Benutzer müssen für Enterprise Voice aktiviert sein, was in der Praxis eine Teams Phone-Lizenz bedeutet. Es kann bis zu einer Stunde dauern, bis ein neu lizenzierter Benutzer in der 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 Anrufweiterleitung, Mitgliedschaft oder Ausnahmebehandlung sowie das Anzeigen von Berichten erfordert die Queues-App, für die jeder Benutzer der App eine Teams Premium-Lizenz benötigt. Das Runbook gewährt nur die Berechtigung und prüft die Lizenzierung der App nicht.

Änderungen an autorisierten Benutzern und Richtlinienzuweisungen werden vom Dienst repliziert und können einige Minuten dauern, 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.

### Ort

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

**Vollständiger 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 Tenant-Informationen 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 der Liste der autorisierten Benutzer hinzugefügt oder daraus entfernt werden. Es können mehrere Benutzer 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 entfernt sie wieder daraus.

| 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 verändert keine Richtlinie. Eine Voice-Applications-Richtlinie zuweisen gewährt die unter „Richtlinienname“ eingegebene Richtlinie. Eine Voice-Applications-Richtlinie 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 | Voice-Applications-Richtlinie |

**Portaloptionen**

| Portaloption                                 | Wert       |
| -------------------------------------------- | ---------- |
| Die Richtlinie unverändert lassen            | Keine      |
| Eine Voice-Applications-Richtlinie zuweisen  | Weisen Sie |
| Eine Voice-Applications-Richtlinie entfernen | Entfernen  |

#### VoiceApplicationsPolicyName

Zu gewährende Voice-Applications-Richtlinie, exakt so benannt wie im Teams Admin Center. Nur mit „Eine Voice-Applications-Richtlinie zuweisen“ verwendet.

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

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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.
