ライセンス割当レポートをスケジュール

設定された閾値に基づいてライセンスの可用性レポートを生成してメール送信します

説明

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

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

メール送信に関する設定

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

この手順は詳細に記載されています メールレポートの設定 ドキュメント。

InputJson の構成

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

• SKUPartNumber (必須): Microsoft の SKU 識別子

• FriendlyName (必須): 表示名

• MinThreshold (任意): 利用可能なライセンス数 < 閾値 のときにアラート

• MaxThreshold (任意): 利用可能なライセンス数 > 閾値 のときにアラート

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

構成例

最小閾値のみ (不足を防ぐため):

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

最大閾値のみ (過剰プロビジョニングを防ぐため):

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

両方の閾値 (範囲を維持するため):

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

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

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    },
    "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 パート番号の調べ方

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 - 古い構成は引き続き動作します。

場所

組織 → 一般 → Report License Assignment_Scheduled

権限

アプリケーション権限

• 種類： Microsoft Graph

  • Organization.Read.All

  • User.Read.All

  • Mail.Send

パラメーター

InputJson

閾値を含む SKU 構成の JSON 配列。各エントリには次を含めるべきです：

• SKUPartNumber: Microsoft の SKU 識別子

• FriendlyName: ライセンスの表示名

• MinThreshold: (省略可) 利用可能であるべき最小ライセンス数

• MaxThreshold: (省略可) 利用可能であるべき最大ライセンス数

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

プロパティ	値
必須	true
デフォルト値
種類	オブジェクト

EmailTo

単一のアドレスまたはカンマ区切りの複数アドレス（文字列）にできます。プライバシー保護のため、関数は各受信者に個別のメールを送信します。

プロパティ	値
必須	true
デフォルト値
種類	文字列

EmailFrom

送信元のメールアドレス。これはランブックのカスタマイズで構成する必要があります

プロパティ	値
必須	false
デフォルト値
種類	文字列

Runbook リファレンスの概要に戻る