> 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/user/userinfo/update-user.md).

# ユーザーを更新

このユーザーのプロファイル詳細、グループ、メールボックス設定を更新します

### 説明

このユーザーの Entra ID 上のプロフィールを、名前、会社、住所、役職、マネージャーなどで更新します。ライセンス グループや追加のグループにユーザーを追加したり、Exchange Online のアーカイブを有効にしたり、パスワードをリセットしたりできます。変更されるのは入力したフィールドのみで、表示名または会社が欠けている場合は自動的に補完されます。

### ロケーション、会社、ライセンス、部署をテンプレートとして提供する

この runbook のほとんどのフィールドは自由入力テキストです。runbook のカスタマイズ テンプレートを使うと、オペレーターはあらかじめ定義された一覧から選択するようになり、ロケーション テンプレートを使えば住所ブロック全体を入力して固定できます。以下の例では、そのようなテンプレートを定義し、runbook のフィールドにバインドしています:

```json
"Templates": {
    "Options": [
        {
            "$id": "LocationOptions",
            "$values": [
                {
                    "表示": "Contoso DE",
                    "値": "ContosoDe",
                    "Customization": {
                        "Default": {
                            "StreetAddress": "Demostr. 22",
                            "郵便番号": "80333",
                            "市": "Munich",
                            "州": "Bavaria",
                            "国": "Germany",
                            "使用場所": "DE"
                        },
                        "ReadOnly": [
                            "StreetAddress",
                            "PostalCode",
                            "City",
                            "国",
                            "使用場所"
                        ]
                    }
                }
            ]
        },
        {
            "$id": "CompanyOptions",
            "$values": [
                {
                    "表示": "CONTOSO",
                    "値": "Contoso"
                }
            ]
        },
        {
            "$id": "LicenseOptions",
            "$values": [
                {
                    "表示": "M365 E3 + E5 セキュリティ + 音声会議",
                    "値": "LIC_M365_E3&E5_SecurityPlan&AudioConf"
                },
                {
                    "表示": "なし",
                    "値": ""
                }
            ]
        },
        {
            "$id": "DepartmentOptions",
            "$values": [
                {
                    "表示": "M&A",
                    "値": "M&A"
                },
                {
                    "表示": "Tax & Legal",
                    "値": "Tax & Legal"
                },
                {
                    "表示": "Controlling & Operations",
                    "値": "Controlling & Operations"
                },
                {
                    "表示": "IT",
                    "値": "IT"
                },
                {
                    "表示": "Communications",
                    "値": "Communications"
                },
                {
                    "表示": "Strategy & Management",
                    "値": "Strategy & Management"
                },
                {
                    "表示": "Accounting",
                    "値": "Accounting"
                },
                {
                    "表示": "Insurance",
                    "値": "Insurance"
                },
                {
                    "表示": "Treasury",
                    "値": "Treasury"
                }
            ]
        }
    ]
},
"Runbooks": {
    "rjgit-user_userinfo_update-user": {
        "ParameterList": [
            {
                "名前": "LocationName",
                "DisplayName": "Office の所在地",
                "表示前": "StreetAddress",
                "Select": {
                    "Options": {
                        "$ref": "LocationOptions"
                    }
                },
                "既定": "ContosoDe"
            },
            {
                "Name": "CompanyName",
                "Select": {
                    "Options": {
                        "$ref": "CompanyOptions"
                    },
                    "AllowEdit": false
                },
                "既定": "Contoso"
            },
            {
                "名前": "DefaultLicense",
                "表示名": "ライセンス",
                "Select": {
                    "Options": {
                        "$ref": "LicenseOptions"
                    },
                    "編集を許可": true
                },
                "既定": "LIC_M365_E3&E5_SecurityPlan&AudioConf"
            },
            {
                "名前": "Department",
                "Select": {
                    "Options": {
                        "$ref": "DepartmentOptions"
                    },
                    "編集を許可": true
                }
            },
            {
                "名前": "ResetPassword",
                "Hide": true
            },
            {
                "名前": "DefaultGroups",
                "既定": "app - 7-Zip,app - Adobe Reader DC Continuous Track,app - glueckkanja-gab KONNEKT"
            }
        ]
    }
}
```

ランブックのカスタマイズ方法の詳細については、 [ランブック カスタマイズ ガイド](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### 場所

User → Userinfo → ユーザーを更新

**完全な Runbook 名**

rjgit-user\_userinfo\_update-user

### 詳細

| プロパティ    | 値                                                                                 |
| -------- | --------------------------------------------------------------------------------- |
| バージョン    | 1.0.2                                                                             |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| スケジュール可能 | いいえ                                                                               |

### 権限

#### アプリケーションのアクセス許可

* **種類**: Microsoft Graph
  * UserAuthenticationMethod.Read.All
    * *MFA が存在する場合、パスワードのリセットをスキップするために、ユーザーの登録済み MFA メソッドを読み取ります*
* **種類**： Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *配布グループとオンライン アーカイブの有効化に使用するアプリ専用の Exchange Online セッションを開きます*

#### RBAC ロール

* ユーザー管理者
  * *プロファイルの更新、パスワードのリセット、マネージャーの割り当て、グループの追加を元に戻します*
* Exchange 管理者
  * *配布グループとオンライン アーカイブを管理するアプリ専用の Exchange Online セッションに必要です*

### パラメーター

#### UserName

Runbook が対象とするユーザーのユーザー プリンシパル名。ポータルで選択されたユーザーから設定されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | true                      |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### 名

新しい名。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 名     |

#### 姓

新しい姓。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 姓     |

#### DisplayName

Microsoft 365 に表示される新しい表示名。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 表示名   |

#### 会社名

ユーザーが所属する会社。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 会社    |

#### 市

ユーザーの住所の市区町村。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 国

ユーザーの住所の国。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 役職

プロフィールに表示される役職。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 役職名   |

#### 部署

ユーザーが所属する部署。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### OfficeLocation

ユーザーが勤務する Office または建物。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | false       |
| 既定値     |             |
| 種類      | 文字列         |
| ポータル表示名 | Office の所在地 |

#### 郵便番号

ユーザーの住所の郵便番号。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 郵便番号  |

#### 優先言語

en-US や de-DE のような言語コード。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 優先言語  |

#### 州

ユーザーの住所の州または地域。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 住所

ユーザーの住所の番地と番地番号。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 住所    |

#### 利用場所

ユーザーが取得できるライセンスを決定する2文字の国コードです。たとえば DE です。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     |       |
| 種類      | 文字列   |
| ポータル表示名 | 利用場所  |

#### 上司ID

このユーザーのマネージャーになるユーザー。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | false  |
| 既定値     |        |
| 種類      | 文字列    |
| ポータル表示名 | マネージャー |

#### 既定のライセンス

ライセンスを割り当てるグループの表示名。ユーザーはそのグループに追加されます。

| プロパティ   | 値               |
| ------- | --------------- |
| 必須      | false           |
| 既定値     |                 |
| 種類      | 文字列             |
| ポータル表示名 | 割り当てるライセンス グループ |

#### 既定のグループ

ユーザーが追加されるグループの表示名。カンマで区切ります。

| プロパティ   | 値        |
| ------- | -------- |
| 必須      | false    |
| 既定値     |          |
| 種類      | 文字列      |
| ポータル表示名 | 追加するグループ |

#### EXO アーカイブを有効にする

ユーザーに対して Exchange Online のアーカイブ メールボックスを有効にします。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | false                  |
| 既定値     | False                  |
| 種類      | ブール値                   |
| ポータル表示名 | アーカイブ メールボックスを有効にしますか? |

#### パスワードのリセット

出力に表示される生成済みの初期パスワードを設定します。これは次回のサインイン時に変更する必要があります。ユーザーにすでに MFA メソッドがある場合はスキップされます。

| プロパティ   | 値               |
| ------- | --------------- |
| 必須      | false           |
| 既定値     | 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/user/userinfo/update-user.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.