> 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/fr/automatisation/runbooks/runbook-references/org/phone/add-or-remove-call-queue-authorized-users.md).

# Ajouter ou supprimer des utilisateurs autorisés d’une file d’attente d’appels Teams

Ajouter ou supprimer des utilisateurs autorisés d’une file d’attente d’appels Teams

### Description

Ajoute les utilisateurs sélectionnés aux utilisateurs autorisés d’une file d’attente d’appels ou les en retire. Les utilisateurs autorisés peuvent modifier les paramètres de la file dans l’application Teams ; Microsoft en autorise 15 par file d’attente d’appels. La stratégie d’applications vocales Teams dont ils ont besoin pour cela peut être attribuée ou retirée dans la même exécution. Les détails sur les vérifications et les options figurent dans la documentation du runbook (docs.realmjoin.com).

### Fonctionnement

La file d’attente d’appels est recherchée par son nom exact. La casse n’a pas d’importance. Si aucune file ne correspond, le runbook liste les noms similaires qu’il a trouvés ; si deux files partagent le même nom, il s’arrête et demande des noms uniques.

Avant toute modification, le runbook affiche les utilisateurs autorisés actuels de la file avec leur stratégie d’applications vocales, puis la modification prévue pour chaque utilisateur sélectionné. Un utilisateur introuvable dans Microsoft Teams, qui n’est pas un compte utilisateur standard ou qui n’est pas activé pour Enterprise Voice est ignoré avec la raison indiquée, et les autres utilisateurs sont tout de même traités. Les utilisateurs déjà autorisés (lors de l’ajout) ou pas du tout autorisés (lors de la suppression) sont signalés et laissés inchangés.

Microsoft autorise 15 utilisateurs autorisés par file d’attente d’appels. Si la sélection devait faire dépasser cette limite à la file, le runbook s’arrête avant toute modification au lieu d’en appliquer une partie.

Les files d’attente d’appels conservent aussi une liste d’utilisateurs autorisés masqués. Lorsqu’un utilisateur autorisé est supprimé, le runbook le retire de cette liste dans la même écriture, afin qu’aucune entrée ne reste orpheline.

Après l’écriture, la file d’attente d’appels est relue et la liste obtenue est comparée à celle attendue. Une divergence est signalée comme avertissement plutôt que comme erreur, car le service applique la modification de manière asynchrone.

### Stratégie d’applications vocales

Être un utilisateur autorisé ne représente que la moitié de l’autorisation. Pour pouvoir réellement modifier les paramètres de la file dans l’application Teams, l’utilisateur a aussi besoin d’une stratégie d’applications vocales Teams qui autorise la gestion des files d’attente d’appels. La stratégie Globale ne le permet généralement pas, c’est pourquoi le runbook le signale lorsqu’il ajoute un utilisateur autorisé qui n’a pas sa propre stratégie.

Le champ de stratégie propose trois options :

* **Laisser la stratégie inchangée** ne modifie aucune affectation de stratégie.
* **Attribuer une stratégie d’applications vocales** attribue la stratégie nommée à chaque utilisateur qui a été ajouté ou qui était déjà autorisé. La stratégie doit exister dans le locataire ; le nom est vérifié avant toute modification. Un utilisateur qui utilise déjà cette stratégie est signalé et n’est pas modifié de nouveau.
* **Retirer la stratégie d’applications vocales** réinitialise l’affectation par utilisateur de chaque utilisateur retiré de la liste.

L’attribution d’une stratégie n’est proposée qu’avec l’ajout d’utilisateurs, et sa suppression uniquement avec la suppression d’utilisateurs. Les deux autres combinaisons sont rejetées immédiatement, car elles modifieraient les autorisations dans le sens inverse de la modification de la file.

Une stratégie atteignant l’utilisateur via une affectation de stratégie de groupe ne peut pas être retirée par utilisateur. Le runbook signale alors la stratégie et le groupe, afin que l’affectation puisse être modifiée à sa source. Si un utilisateur possède à la fois une affectation directe et une affectation de groupe, la suppression de l’affectation directe laisse l’affectation de groupe prendre le relais ; le runbook le précise dans la sortie.

Avant de retirer une stratégie, le runbook examine toutes les autres files d’attente d’appels et les standards automatiques pour cet utilisateur. Si l’utilisateur est encore un utilisateur autorisé ailleurs, la stratégie est conservée et les objets concernés sont indiqués dans un avertissement. L’utilisateur est tout de même retiré de cette file d’attente d’appels.

### Notes et limites

Les utilisateurs autorisés doivent être activés pour Enterprise Voice, ce qui signifie en pratique une licence Teams Phone. Un utilisateur venant d’obtenir une licence peut mettre jusqu’à une heure avant d’être visible dans Teams PowerShell ; d’ici là, le runbook le signale comme introuvable.

Les flux d’appels d’accueil et de jours fériés peuvent être modifiés directement par les utilisateurs autorisés dans le client Teams. La modification du routage des appels, de l’appartenance ou de la gestion des exceptions, ainsi que l’affichage des rapports, nécessitent l’application Queues, qui demande une licence Teams Premium pour chaque utilisateur de l’application. Le runbook accorde uniquement l’autorisation et ne vérifie pas la licence de l’application.

Les modifications des utilisateurs autorisés et des affectations de stratégie sont répliquées par le service et peuvent mettre quelques minutes à apparaître dans le centre d’administration Teams et dans le client Teams.

Le fait qu’un utilisateur autorisé soit masqué est seulement conservé, jamais modifié volontairement. Utilisez le centre d’administration Teams pour masquer ou afficher un utilisateur autorisé.

### Emplacement

Organisation → Téléphonie → Ajouter ou supprimer des utilisateurs autorisés d’une file d’attente d’appels

**Nom complet du runbook**

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

### Détails

| Propriété      | Valeur                                                                  |
| -------------- | ----------------------------------------------------------------------- |
| Version        | 1.0.0                                                                   |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>MicrosoftTeams (>= 7.9.0)</p> |
| Planifiable    | non                                                                     |

### Autorisations

#### Autorisations d’application

* **Type**: Microsoft Graph
  * Organization.Read.All
    * *Requis par la connexion Teams PowerShell basée sur une application (Connect-MicrosoftTeams -Identity) pour lire les informations du locataire*

#### rôles RBAC

* Administrateur Teams
  * *Nécessaire pour exécuter Get-CsCallQueue, Set-CsCallQueue, Get-CsAutoAttendant, Get-CsOnlineUser, Get-CsUserPolicyAssignment, Get-CsTeamsVoiceApplicationsPolicy et Grant-CsTeamsVoiceApplicationsPolicy via Teams PowerShell basé sur une application*

### Paramètres

#### CallQueueName

Nom exact de la file d’attente d’appels tel qu’il apparaît dans le centre d’administration Teams. La casse n’a pas d’importance.

| Propriété                  | Valeur                            |
| -------------------------- | --------------------------------- |
| Obligatoire                | vrai                              |
| Valeur par défaut          |                                   |
| Type                       | Chaîne                            |
| Nom d’affichage du portail | Nom de la file d’attente d’appels |

#### UserIds

Utilisateurs ajoutés à la liste des utilisateurs autorisés ou retirés de celle-ci. Plusieurs utilisateurs peuvent être sélectionnés à la fois ; chacun doit être activé pour Teams Phone.

| Propriété                  | Valeur       |
| -------------------------- | ------------ |
| Obligatoire                | vrai         |
| Valeur par défaut          |              |
| Type                       | String\[]    |
| Nom d’affichage du portail | Utilisateurs |

#### Supprimer

Ajouter des utilisateurs en tant qu’utilisateurs autorisés les place sur la liste des utilisateurs autorisés de la file. Supprimer des utilisateurs en tant qu’utilisateurs autorisés les en retire à nouveau.

| Propriété                  | Valeur  |
| -------------------------- | ------- |
| Obligatoire                | faux    |
| Valeur par défaut          | Faux    |
| Type                       | Booléen |
| Nom d’affichage du portail | Action  |

**Options du portail**

| Option du portail                                            | Valeur |
| ------------------------------------------------------------ | ------ |
| Ajouter des utilisateurs en tant qu’utilisateurs autorisés   | faux   |
| Supprimer des utilisateurs en tant qu’utilisateurs autorisés | vrai   |

#### Action de stratégie VoiceApplicationsPolicy

Laisser la stratégie inchangée n’applique aucune stratégie. Attribuer une stratégie d’applications vocales accorde la stratégie saisie sous « Nom de la stratégie ». Retirer la stratégie d’applications vocales réinitialise une affectation par utilisateur lorsque les utilisateurs sont retirés de la liste.

| Propriété                  | Valeur                           |
| -------------------------- | -------------------------------- |
| Obligatoire                | faux                             |
| Valeur par défaut          | Aucun                            |
| Type                       | Chaîne                           |
| Nom d’affichage du portail | Stratégie d’applications vocales |

**Options du portail**

| Option du portail                              | Valeur    |
| ---------------------------------------------- | --------- |
| Laisser la stratégie inchangée                 | Aucun     |
| Attribuer une stratégie d’applications vocales | Attribuer |
| Retirer la stratégie d’applications vocales    | Supprimer |

#### Nom de la stratégie d’applications vocales

Stratégie d’applications vocales à accorder, nommée exactement comme dans le centre d’administration Teams. Utilisée uniquement avec « Attribuer une stratégie d’applications vocales ».

| Propriété                  | Valeur              |
| -------------------------- | ------------------- |
| Obligatoire                | faux                |
| Valeur par défaut          |                     |
| Type                       | Chaîne              |
| Nom d’affichage du portail | Nom de la stratégie |

[Retour à l’aperçu de la référence du runbook](/fr/automatisation/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/fr/automatisation/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.