# ライセンス割り当てレポート（スケジュール済み）

### 説明

このランブックは、送信された SKU に基づいてライセンスの可用性を確認し、しきい値に達した場合はメールレポートを送信します。しきい値は 2 種類設定できます。1 つ目は最小しきい値で、利用可能なライセンス数が指定数を下回るとアラートを発します。2 つ目は最大しきい値で、利用可能なライセンス数が指定数を超えるとアラートを発します。レポートには、設定されたしきい値の範囲外にあるライセンスの詳細情報が含まれ、それらを CSV ファイルにエクスポートし、メールで送信します。

### ランブックのカスタマイズ

#### メール送信に関するセットアップ

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

この手順については、 [メール レポートのセットアップ](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) ドキュメントで詳しく説明されています。

#### InputJson の構成

各ライセンス構成には、次が必要です:

* **SKUPartNumber** (必須): Microsoft SKU 識別子
* **FriendlyName** (必須): 表示名
* **MinThreshold** (任意): 利用可能なライセンス数がしきい値未満の場合にアラート
* **MaxThreshold** (任意): 利用可能なライセンス数がしきい値を超えた場合にアラート

各ライセンスにつき、少なくとも 1 つのしきい値を設定する必要があります。

#### 構成例

**最小しきい値のみ** (不足を防止):

```json
[
    {
        "SKUPartNumber": "ENTERPRISEPACK",
        "FriendlyName": "Microsoft 365 E3",
        "MinThreshold": 50
    }
]
```

**最大しきい値のみ** (過剰プロビジョニングを防止):

```json
[
    {
        "SKUPartNumber": "POWER_BI_PRO",
        "FriendlyName": "Power BI Pro",
        "MaxThreshold": 500
    }
]
```

**両方のしきい値** (範囲を維持):

```json
[
    {
        "SKUPartNumber": "ENTERPRISEPREMIUM",
        "FriendlyName": "Microsoft 365 E5",
        "MinThreshold": 50,
        "MaxThreshold": 150
    }
]
```

#### ランブックの完全なカスタマイズ

```json
{
    "Settings": {
        "RJReport": {
            "EmailSender": "sender@contoso.com"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "EmailTo": {
                    "DisplayName": "受信者のメール アドレス"
                },
                "InputJson": {
                    "Hide": true,
                    "DefaultValue": [
                        {
                            "SKUPartNumber": "SPE_E5",
                            "FriendlyName": "Microsoft 365 E5",
                            "MinThreshold": 20,
                            "MaxThreshold": 30
                        },
                        {
                            "SKUPartNumber": "FLOW_FREE",
                            "FriendlyName": "Microsoft Power Automate Free",
                            "MinThreshold": 10
                        }
                    ]
                },
                "EmailFrom": {
                    "Hide": true
                },
                "CallerName": {
                    "Hide": true
                }
            }
        }
    }
}
```

### SKU 部品番号の確認

```powershell
Connect-MgGraph -Scopes "Organization.Read.All"
Get-MgSubscribedSku | Select-Object SkuPartNumber, SkuId | Sort-Object SkuPartNumber
```

一般的な SKU:

* `ENTERPRISEPACK` - Microsoft 365 E3
* `ENTERPRISEPREMIUM` - Microsoft 365 E5
* `EMS` - Enterprise Mobility + Security E3

### 出力

**違反が検出された場合:**

* ジョブ ログのコンソール出力
* CSV エクスポート (`License_Threshold_Violations.csv`)
* 要約、違反、推奨事項、および CSV 添付ファイルを含むメール レポート

**すべてがしきい値内の場合:**

* メールは送信されません
* ジョブは正常に完了します

### トラブルシューティング

**SKU が見つかりません**: 次を使用して SKU の存在を確認してください `Get-MgSubscribedSku`

**メールが送信されません**: EmailFrom の構成と Mail.Send 権限を確認してください

**無効な JSON**: 構成する前に JSON 形式を検証してください

### 移行 नोट

レガシー `WarningThreshold` に自動的にマップされます `MinThreshold` - 以前の構成は引き続き機能します。

### 場所

Organization → General → Report License Assignment (Scheduled)

**ランブックの完全名**

rjgit-org\_general\_report-license-assignment\_scheduled

### アクセス許可

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

* **種類**: Microsoft Graph
  * Organization.Read.All
  * User.Read.All
  * Mail.Send

### パラメーター

#### InputJson

しきい値を含む SKU 構成を格納した JSON 配列。各エントリには、Microsoft SKU 識別子用の SKUPartNumber、ライセンスの表示名としての FriendlyName、利用可能であるべきライセンスの最小数を指定する任意の MinThreshold、利用可能であるべきライセンスの最大数を指定する任意の MaxThreshold を含める必要があります。

これはランブックのカスタマイズで構成する必要があります

| プロパティ | 値      |
| ----- | ------ |
| 必須    | true   |
| 既定値   |        |
| 種類    | オブジェクト |

#### EmailTo

受信者のメール アドレス、またはカンマ区切りの受信者リスト。

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

#### EmailFrom

設定から解決される送信者のメール アドレス。

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

[ランブック リファレンスの概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/general/report-license-assignment_scheduled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.