> 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-agents.md).

# Anrufwarteschlangen-Agenten hinzufügen oder entfernen

Agenten einer Teams-Anrufwarteschlange hinzufügen oder entfernen

### Beschreibung

Fügt die ausgewählten Benutzer als einzeln zugewiesene Agenten einer Teams-Anrufwarteschlange hinzu oder entfernt sie aus dieser Liste. Agenten, die aus einer Gruppe, einem Team oder einem Schichtplan stammen, werden nicht angetastet; die Ausgabe nennt stattdessen, wo sie verwaltet werden. Benutzer ohne Enterprise Voice werden unter Angabe des Grundes übersprungen. Details zu den Prüfungen und Grenzen stehen in der Runbook-Dokumentation (docs.realmjoin.com).

### So funktioniert es

Eine Anrufwarteschlange erhält ihre Agenten auf genau eine von drei Arten, und die Art wird im Teams admin center unter „Anrufannahme“ ausgewählt:

* **Benutzer und Gruppen** - Agenten werden einzeln, über Gruppen oder beides zugewiesen. Dies ist der einzige Modus, den das Runbook ändert. Es fügt die ausgewählten Benutzer der Liste der einzeln zugewiesenen Agenten hinzu oder entfernt sie daraus und lässt die zugewiesenen Gruppen unverändert.
* **Ein Team und ein Kanal** - jedes Mitglied des Teams dieses Kanals ist ein Agent. Das Runbook gibt das Team und den Kanal aus und bricht ohne Änderung ab, weil die Mitgliedschaft im Team verwaltet wird.
* **Ein Schichtplan** - Agenten stammen aus einer Planungsgruppe in der Shifts-App. Das Runbook gibt das Team hinter dem Schichtplan aus und bricht ohne Änderung ab.

Bevor etwas geschrieben wird, listet das Runbook die aktuellen Agenten auf und prüft jeden ausgewählten Benutzer. Benutzer, die kein Agent werden können, werden unter Angabe des Grundes übersprungen, die übrigen werden dennoch verarbeitet. Das Hinzufügen eines Benutzers, der bereits ein Agent ist, oder das Entfernen eines Benutzers, der keiner ist, wird als „Keine Aktion ausgeführt“ gemeldet und ändert nichts.

Zwei Situationen stoppen den Lauf, bevor eine Änderung vorgenommen wird: Die Anrufwarteschlange hätte am Ende mehr als 20 einzeln zugewiesene Agenten, oder eine Entfernung würde dazu führen, dass die Anrufwarteschlange gar keine Agenten und keine Gruppen mehr hat. Im zweiten Fall zuerst einen Agenten behalten oder der Anrufwarteschlange im Teams admin center eine Gruppe oder ein Team zuweisen.

Nach der Änderung liest das Runbook die Anrufwarteschlange erneut aus und vergleicht die Agentenliste mit dem Gewünschten. Eine Abweichung wird als Warnung gemeldet, damit sie im Teams admin center geprüft werden kann.

### Anforderungen an Agenten

* Ein Agent benötigt eine Teams Phone-Lizenz mit aktivierter Enterprise Voice. Benutzer ohne diese Lizenz werden unter Angabe dieses Grundes übersprungen; richten Sie Teams Phone für sie ein und führen Sie das Runbook erneut aus.
* Agenten, die Anrufe in der Teams-App annehmen, müssen sich im Upgrade-Modus TeamsOnly befinden. Ein anderer Modus wird als Warnung gemeldet, der Benutzer wird jedoch trotzdem hinzugefügt.
* Nur reguläre Benutzerkonten können Agenten sein. Ressourcenkonten und Gäste werden übersprungen.
* Microsoft erlaubt 20 einzeln zugewiesene Agenten pro Anrufwarteschlange und bis zu 200 Agenten, wenn sie über Gruppen kommen. Verwenden Sie für größere Teams eine Gruppe.
* Änderungen an Lizenzen und Richtlinien brauchen Zeit, um den Teams-Dienst zu erreichen. Nach einer neuen Teams Phone-Lizenz kann es etwa eine Stunde dauern, bis ein Benutzer als Agent zugewiesen werden kann.
* Bei einem Benutzer, der über eine Gruppe zum Agenten wird, kann es bis zu acht Stunden dauern, bis die Warteschlange den ersten Anruf anbietet.

### Hinweise und Einschränkungen

* Das Runbook ändert niemals die Mitgliedschaft einer Gruppe oder eines Teams. Eine Warteschlange, die ihre Agenten aus einer Gruppe, einem Teamkanal oder einem Schichtplan bezieht, wird mit dem Ort gemeldet, an dem ihre Mitglieder verwaltet werden.
* Warteschlangen, die einzeln zugewiesene Benutzer mit Gruppen mischen, werden unterstützt. Nur die individuellen Zuweisungen werden geändert; die Gruppen bleiben unverändert und ihre Mitglieder sind weiterhin Agenten.
* Die Agentenliste einer Anrufwarteschlange ist die dienstinterne Auflösung von Benutzern und Gruppenmitgliedern und wird zwischengespeichert. Ein Benutzer, der gerade zu einer der zugewiesenen Gruppen hinzugefügt wurde, kann weiterhin als kein Agent gemeldet werden, und ein aus einer Gruppe entfernter Benutzer kann noch eine Weile aufgeführt sein.
* Das vollständige Leeren der Agentenliste ist hier absichtlich nicht möglich. Das Entfernen des letzten Agenten einer Warteschlange ohne Gruppen wird abgelehnt, weil eine Warteschlange ohne Agenten keine Anrufe annehmen kann. Tun Sie das im Teams admin center, wenn es wirklich beabsichtigt ist.
* Gruppen-, Team- und Kanalnamen stammen aus Microsoft Graph. Ohne die optionalen Berechtigungen dafür gibt das Runbook stattdessen die Objekt-IDs aus und funktioniert genau gleich.

### Speicherort

Organisation → Telefon → Anrufwarteschlangen-Agenten hinzufügen oder entfernen

**Voller Runbook-Name**

rjgit-org\_phone\_add-or-remove-call-queue-agents

### Details

| Eigenschaft          | Wert                                                                                                                  |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Version              | 1.0.0                                                                                                                 |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>MicrosoftTeams (>= 7.9.0)<br>Microsoft.Graph.Authentication (>= 2.41.2)</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*
  * Channel.ReadBasic.All *(optional — Funktion: Gruppen-, Team- und Kanalnamen in der Ausgabe)*
    * *Löst den Kanalnamen einer Anrufwarteschlange auf, die über einen Teamkanal beantwortet wird*
  * GroupMember.Read.All *(optional — Funktion: Gruppen-, Team- und Kanalnamen in der Ausgabe)*
    * *Löst die Anzeigenamen der Gruppen und Schicht-Teams auf, die der Anrufwarteschlange zugewiesen sind*
  * Team.ReadBasic.All *(optional — Funktion: Gruppen-, Team- und Kanalnamen in der Ausgabe)*
    * *Listet die Teams des Kanalbesitzers auf, um das Team hinter dem beantwortenden Kanal zu finden*

#### RBAC-Rollen

* Teams-Administrator
  * *Erforderlich, um Get-CsCallQueue, Set-CsCallQueue und Get-CsOnlineUser über app-basierte Teams PowerShell auszuführen*

### Parameter

#### CallQueueName

Exakter Name der Anrufwarteschlange, wie er im Teams admin center angezeigt wird. Groß- und Kleinschreibung spielen keine Rolle, aber der Name muss genau zu einer Warteschlange passen.

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

#### UserIds

Benutzer, die hinzugefügt oder entfernt werden sollen, mehrere auf einmal. Um als Agent zu arbeiten, benötigt ein Benutzer eine Teams Phone-Lizenz mit aktivierter Enterprise Voice.

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

#### Entfernen

Das Hinzufügen von Benutzern als Agenten fügt sie der Liste der einzeln zugewiesenen Agenten hinzu. Das Entfernen von Benutzern als Agenten entfernt sie daraus; Agenten, die aus einer Gruppe oder einem Team stammen, bleiben unverändert.

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

**Portaloptionen**

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

[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-agents.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.