> 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/ja/zi-dong-hua/runbooks/runbook-references/org/phone/add-or-remove-call-queue-authorized-users.md).
# 通話キューの承認済みユーザーを追加または削除
Teams 通話キューの承認済みユーザーを追加または削除します
### 説明
選択したユーザーを通話キューの承認済みユーザーに追加したり、削除したりします。承認済みユーザーは Teams app でキュー設定を変更できます。Microsoft では、通話キューごとに 15 人まで許可されています。そのために必要な Teams の音声アプリケーション ポリシーも、同じ実行で割り当てまたは削除できます。チェックとオプションの詳細は、runbook のドキュメント (docs.realmjoin.com) にあります。
### 仕組み
通話キューは完全一致する名前で検索されます。大文字・小文字は区別されません。一致するキューがない場合、runbook は見つかった類似名を一覧表示します。2 つのキューが同じ名前を共有している場合は処理を停止し、固有の名前を求めます。
何かを変更する前に、runbook はキューの現在の承認済みユーザーとその音声アプリケーション ポリシー、続いて選択した各ユーザーに対する予定変更を表示します。Microsoft Teams で見つからない、通常のユーザー アカウントではない、または Enterprise Voice が有効でないユーザーは理由付きでスキップされ、残りのユーザーは引き続き処理されます。すでに承認済みのユーザー（追加時）またはまったく承認されていないユーザー（削除時）は報告され、そのまま残されます。
Microsoft では、通話キューごとに承認済みユーザーを 15 人まで許可しています。選択によってキューがその上限を超える場合、runbook は一部だけを適用するのではなく、変更前に停止します。
通話キューには、非表示の承認済みユーザーの一覧も保持されます。承認済みユーザーが削除されると、runbook は同じ書き込みでその一覧からも削除するため、エントリが残りっぱなしになることはありません。
書き込み後、通話キューが再度読み取られ、結果の一覧が期待値と比較されます。不一致は、サービスが変更を非同期で適用するため、エラーではなく警告として報告されます。
### 音声アプリケーション ポリシー
承認済みユーザーであることは権限の半分にすぎません。実際に Teams app でキュー設定を変更するには、そのユーザーに通話キュー管理を許可する Teams の音声アプリケーション ポリシーも必要です。通常、Global ポリシーでは許可されないため、独自のポリシーを持たない承認済みユーザーを追加するときに runbook は警告します。
ポリシー フィールドには 3 つのオプションがあります:
* **ポリシーを変更しない** ポリシーの割り当ては変更しません。
* **音声アプリケーション ポリシーを割り当てる** 追加されたすべてのユーザー、またはすでに承認済みのすべてのユーザーに、指定したポリシーを付与します。ポリシーは Tenant に存在している必要があり、変更を行う前に名前が確認されます。すでにそのポリシーを使用しているユーザーは報告され、再度変更されることはありません。
* **音声アプリケーション ポリシーを削除する** リストから外されたすべてのユーザーのユーザー別割り当てをリセットします。
ポリシーの割り当てはユーザーの追加と同時にのみ選択でき、1 つの削除はユーザーの削除と同時にのみ選択できます。その他 2 つの組み合わせは、キューの変更と逆方向に権限を変更するため、直ちに拒否されます。
グループ ポリシー割り当てによってユーザーに到達したポリシーは、ユーザー単位では削除できません。runbook は代わりにそのポリシーとグループを報告するため、割り当て元で変更できます。ユーザーに直接割り当てとグループ割り当ての両方がある場合、直接割り当てを削除するとグループ割り当てが引き継ぎます。runbook はそのことを出力で示します。
ポリシーを削除する前に、runbook はそのユーザーの他のすべての通話キューと自動応答を検索します。ユーザーがどこかでまだ承認済みユーザーである場合、ポリシーは保持され、影響を受けるオブジェクトが警告で示されます。そのユーザーはこの通話キューからは引き続き削除されます。
### 注記と制限
承認済みユーザーは Enterprise Voice を有効化している必要があり、実際には Teams Phone ライセンスを意味します。新しくライセンスされたユーザーが Teams PowerShell から見えるようになるまで、最大 1 時間かかることがあります。それまでは runbook はそれらを見つからないものとして報告します。
あいさつと休日の通話フローは、承認済みユーザーが Teams クライアントで直接変更できます。通話ルーティング、メンバーシップ、例外処理の変更とレポートの表示には Queues app が必要で、アプリのユーザーごとに Teams Premium ライセンスが必要です。runbook は権限を付与するだけで、アプリのライセンスは確認しません。
承認済みユーザーとポリシー割り当てへの変更はサービスによって複製され、Teams 管理センターおよび Teams クライアントに反映されるまで数分かかることがあります。
承認済みユーザーが非表示かどうかは維持されるだけで、意図的に変更されることはありません。承認済みユーザーを非表示または再表示するには Teams 管理センターを使用してください。
### 場所
組織 → 電話 → 通話キューの承認済みユーザーを追加または削除
**完全な Runbook 名**
rjgit-org\_phone\_add-or-remove-call-queue-authorized-users
### 詳細
| プロパティ | 値 |
| -------- | ----------------------------------------------------------------------- |
| バージョン | 1.0.0 |
| 必須モジュール | RealmJoin.RunbookHelper (>= 0.8.10)
MicrosoftTeams (>= 7.9.0)
|
| スケジュール可能 | いいえ |
### 権限
#### アプリケーションのアクセス許可
* **種類**: Microsoft Graph
* Organization.Read.All
* *アプリベースの Teams PowerShell サインイン (Connect-MicrosoftTeams -Identity) でテナント情報を読み取るために必要*
#### RBAC ロール
* Teams 管理者
* *アプリベースの Teams PowerShell を介して Get-CsCallQueue、Set-CsCallQueue、Get-CsAutoAttendant、Get-CsOnlineUser、Get-CsUserPolicyAssignment、Get-CsTeamsVoiceApplicationsPolicy および Grant-CsTeamsVoiceApplicationsPolicy を実行するために必要です*
### パラメーター
#### CallQueueName
Teams 管理センターに表示されるとおりの通話キューの正確な名前。大文字・小文字は区別されません。
| プロパティ | 値 |
| ------- | ------ |
| 必須 | true |
| 既定値 | |
| 種類 | 文字列 |
| ポータル表示名 | 通話キュー名 |
#### UserIds
承認済みユーザーの一覧に追加または削除するユーザー。複数のユーザーを同時に選択できます。各ユーザーで Teams Phone が有効になっている必要があります。
| プロパティ | 値 |
| ------- | --------- |
| 必須 | true |
| 既定値 | |
| 種類 | String\[] |
| ポータル表示名 | ユーザー |
#### 削除
Add users as authorized users は、それらをキューの承認済みユーザー一覧に追加します。Remove users as authorized users は、それらを一覧から再び削除します。
| プロパティ | 値 |
| ------- | ----- |
| 必須 | false |
| 既定値 | False |
| 種類 | ブール値 |
| ポータル表示名 | アクション |
**ポータルのオプション**
| ポータル オプション | 値 |
| -------------------- | ----- |
| ユーザーを承認済みユーザーとして追加する | false |
| ユーザーを承認済みユーザーとして削除する | true |
#### 音声アプリケーション ポリシー アクション
「ポリシーを変更しない」はポリシーに変更を加えません。「音声アプリケーション ポリシーを割り当てる」は、「ポリシー名」欄に入力されたポリシーを付与します。「音声アプリケーション ポリシーを削除する」は、ユーザーがリストから外されたときにユーザーごとの割り当てをリセットします。
| プロパティ | 値 |
| ------- | --------------- |
| 必須 | false |
| 既定値 | なし |
| 種類 | 文字列 |
| ポータル表示名 | 音声アプリケーション ポリシー |
**ポータルのオプション**
| ポータル オプション | 値 |
| --------------------- | ----- |
| ポリシーを変更しない | なし |
| 音声アプリケーション ポリシーを割り当てる | 割り当てる |
| 音声アプリケーション ポリシーを削除する | 削除 |
#### 音声アプリケーション ポリシー名
Teams 管理センターと同じ名称で指定する、付与する音声アプリケーション ポリシー。「音声アプリケーション ポリシーを割り当てる」と一緒にのみ使用されます。
| プロパティ | 値 |
| ------- | ----- |
| 必須 | false |
| 既定値 | |
| 種類 | 文字列 |
| ポータル表示名 | ポリシー名 |
[Runbook リファレンスの概要に戻る](/ja/zi-dong-hua/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/ja/zi-dong-hua/runbooks/runbook-references/org/phone/add-or-remove-call-queue-authorized-users.md?ask=&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.