> 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/security/set-or-remove-mobile-phone-mfa.md).

# 携帯電話 MFA を設定または削除

### 説明

ユーザーのモバイル電話の認証方法を追加、更新、または削除します。この runbook は、電話番号を通常の MFA 要素（通話/テキスト認証）として管理します。重要: Microsoft Graph の phoneMethods API では、自動 SMS サインイン登録の試行を発生させずに電話番号を「MFA のみ」として追加する方法は提供されていません。ユーザーが Tenant の Authentication Methods Policy で SMS サインインを有効にされている場合、Graph は電話方法の作成または更新後に、その番号を SMS サインインに登録しようと自動的に試みます。その番号がすでに別のユーザーによって SMS サインインに使用されている場合、Graph はエラー コード "phoneNumberNotUnique" の 409 Conflict を返します。ただし、このエラーが発生しても、電話方法自体（通常の MFA 用）は通常、正常に作成または更新されます。smsSignInState プロパティは読み取り専用であり、create/update リクエストでは制御できません。SMS サインインは、別個の enableSmsSignIn および disableSmsSignIn エンドポイントを介してのみ明示的に管理できます。この runbook は、このようなエラーの後に実際の状態を検証し、MFA 方法が割り当てられていれば、SMS サインインの競合に関する警告付きで成功として報告します。割り当てが本当に失敗した場合は、その番号を保持しているユーザーを検索します。

### ユーザー通知を有効にする

この runbook は、管理者によってモバイル電話の MFA 方法が追加、更新、または削除されたことを通知するメールを対象ユーザーに送信することもできます。これを有効にするには、runbook のカスタマイズでユーザー通知を有効化する必要があります。

このための json 構成は次のとおりです:

```json
"rjgit-user_security_set-or-remove-mobile-phone-mfa": {
    "parameters": {
        "UserId": {
            "Hide": true
        },
        "NotifyUser": {
            "Default": true,
            "Hide": true
        },
        "EmailFrom": {
            "Hide": true
        },
        "ServiceDeskDisplayName": {
            "Hide": true
        },
        "ServiceDeskEmail": {
            "Hide": true
        },
        "ServiceDeskPhone": {
            "Hide": true
        },
        "ServiceDeskPortalUrl": {
            "Hide": true
        },
        "ServiceDeskTicketUrl": {
            "Hide": true
        },
        "LanguageOverride": {
            "Hide": true
        },
        "CallerName": {
            "Hide": true
        }
    }
}
```

runbook をカスタマイズする方法の詳細については、 [Runbook カスタマイズガイド](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### メール送信に関する設定

通知メールの送信はオプションであり、 `NotifyUser` が有効になっている場合にのみ行われます。送信者アドレスは `RJReport.EmailSender` Tenant 設定から取得されます。

この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメールアドレスを構成する必要があります。

詳細については [RealmJoin Report Settings のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) を参照してください。

### 場所

ユーザー → セキュリティ → モバイル電話 MFA の設定または削除

**完全な Runbook 名**

rjgit-user\_security\_set-or-remove-mobile-phone-MFA

### アクセス許可

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

* **種類**: Microsoft Graph
  * AuditLog.Read.All
  * User.Read.All
  * UserAuthenticationMethod.ReadWrite.All
  * Mail.Send

### パラメーター

#### UserId

対象ユーザーのオブジェクト ID。

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

#### phoneNumber

国際 E.164 形式のモバイル電話番号（例: +491701234567）。

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

#### 削除

実行するアクションとして、「モバイル電話 MFA 方法の設定/更新」（最終値: $false）または「モバイル電話 MFA 方法の削除」（最終値: $true）を選択できます。true に設定すると、runbook はユーザーのモバイル電話 MFA 方法を削除します。false に設定すると、指定された電話番号でモバイル電話 MFA 方法を追加または更新します。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | False |
| 種類    | ブール値  |

#### NotifyUser

有効にすると、管理者によってモバイル電話の MFA 方法が追加または削除されたことを通知するメールを対象ユーザーに送信します。既定では無効です。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | False |
| 種類    | ブール値  |

#### EmailFrom

任意の通知メールの送信者メールアドレス。RealmJoin の Tenant 設定 RJReport.EmailSender から取得されます。

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

#### ServiceDeskDisplayName

ユーザー連絡先情報用の Service Desk 表示名（任意）。RealmJoin の Tenant 設定 RJReport.ServiceDesk\_DisplayName から取得されます。

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

#### ServiceDeskEmail

ユーザー連絡先情報用の Service Desk メールアドレス（任意）。RealmJoin の Tenant 設定 RJReport.ServiceDesk\_EMail から取得されます。

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

#### ServiceDeskPhone

ユーザー連絡先情報用の Service Desk 電話番号（任意）。RealmJoin の Tenant 設定 RJReport.ServiceDesk\_Phone から取得されます。

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

#### ServiceDeskPortalUrl

ユーザー連絡先情報用の Service Desk ポータル URL。クリック可能なリンクとして表示されます（任意）。RealmJoin の Tenant 設定 RJReport.ServiceDesk\_PortalUrl から取得されます。

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

#### ServiceDeskTicketUrl

この要求に関連する Service Desk チケットへの直接リンク。クリック可能なリンクとして表示されます（任意）。既定では空のため、チケットリンクは追加されません。

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

#### LanguageOverride

通知メールに使用する言語を上書きします。使用できる値は 'DE'（ドイツ語）または 'EN'（英語）です。空欄の場合、言語は対象ユーザーの使用場所に基づいて自動的に決定されます。

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

[Runbook Reference の概要に戻る](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
