ライセンス割り当ての報告（スケジュール）

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

説明

このランブックは、送信された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 - 古い構成は引き続き動作します。

場所

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
デフォルト値
種類	文字列

ランブック リファレンスの概要に戻る