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

ライセンスの利用可能数がしきい値を超えたら警告

これはスケジュール済みの runbook です。単一のオブジェクトでトリガーされるのではなく、定期的なスケジュールで実行されるように設計されています。詳細はスケジューリング runbook のスケジュールを構成する方法の詳細については

説明

構成された SKU のライセンスがあとどれだけ利用可能かを確認します。数が最小しきい値を下回るか、最大しきい値を上回ると、影響を受ける SKU が報告されるため、ライセンスを適時購入または回収できます。レポートはメールで送信することも、ダウンロードリンクとして提供することもできます。

ライセンス構成

確認対象の SKU とそのしきい値は、runbook customization で非表示の 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
    }
]

runbook customization の完全な設定

{
    "Settings": {
        "RJReport": {
            "EmailSender": "sender@contoso.com"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "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
                        }
                    ]
                }
            }
        }
    }
}

詳細については Runbook カスタマイズガイド構文について。

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

結果

各実行では、結果が RealmJoin ポータルの Output Data タブに書き込まれます。要約、しきい値の外にあるライセンス、テナントに存在しない構成済み SKU、しきい値内のライセンスが含まれます。各テーブルはそこで Excel にエクスポートできます。

違反が検出された場合： レポートファイル（CSV および/または Excel ブック）には、しきい値の外にあるライセンスが一覧表示され、メールには要約、違反内容、推奨事項、および添付ファイルが含まれます。
構成済み SKU が見つからない場合： メールには、その SKU が構成上の問題として記載されます。
すべてのライセンスがしきい値内にある場合： メールは送信されず、レポートファイルも作成されず、実行は正常に完了します。

レポートの配信

レポートファイルは、配信方法が次の レポートの配信 オプション（メールおよび/またはダウンロードリンク）が選択され、かつ少なくとも1つのライセンスがしきい値を外れている場合は Output Dataのみ 選択すると、結果は RealmJoin ポータルの Output Data タブで直接読み取られ、各テーブルは Excel にエクスポートすることもできます。メール配信とダウンロードリンクの生成は独立しており、組み合わせることができます。

ダウンロードリンクの場合、レポートファイルは、次で構成された Azure の Storage Account にアップロードされます。 RJReport.StorageAccount.* テナント設定に保存され、期限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは Automation account のマネージド ID で認証され、その ID には Storage Account Contributor 対象の Storage Account に対する RBAC ロール（これは Azure RBAC の割り当てであり、Graph のアプリケーション権限ではありません）。

次より前に作成されたスケジュールは、 レポートの配信 オプションが存在していなかった頃からメール送信を継続します。保存済みの宛先だけでも、そのスケジュールのメール送信は有効になります。そのようなスケジュールを編集のために開くと、オプションには Output Dataのみと表示されます。保存する前にもう一度配信方法を選択してください。そうしないと、そのスケジュールはレポートの送信を停止します。

メール送信に関する設定

メールレポートの送信は任意で、次の場合にのみ行われます レポートもメール送信する または レポートもメール送信し、ダウンロードリンクを付ける がレポート配信として選択されている場合、受信者が必要になります。送信者アドレスは次の場所から取得されます: RJReport.EmailSender Tenant 設定から取得されます。

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

詳細については RealmJoin Report Settings のドキュメントを参照してください。

メールのブランド設定

レポートメールでは、任意の RJReport.Branding.* Tenant 設定が使用されます:

ヘッダーおよびフッター画像 - 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
フッターリンク - フッター画像の対象
アクセントカラーとテキストカラー - 6桁の16進値、例: #0052cc

これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像、あるいは無効な色値があっても、レポートのメール送信が妨げられることはありません。代わりに対応する既定値が使用されます。

設定手順と画像要件: メールのブランド設定.

トラブルシューティング

SKU が見つからない：SKU が存在することを次で確認してください Get-MgSubscribedSku.

メールが送信されない：次を確認してください RJReport.EmailSender 設定と、マネージド ID の Mail.Send 権限を確認してください。すべてのライセンスがしきい値内にある場合、メールは送信されません。

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

移行に関する注意

レガシー WarningThreshold は自動的に次にマップされます MinThreshold - 旧構成は引き続き動作します。

場所

組織 → 全般 → ライセンス割り当てレポート (スケジュール済み)

Runbook の完全名

rjgit-org_general_report-license-assignment_scheduled

詳細

プロパティ

値

バージョン

1.4.0

必要なモジュール

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)

スケジュール可能

はい

権限

アプリケーションの権限

種類: Microsoft Graph
- Organization.Read.All
  - /organization と /subscribedSkus を読み取り、ライセンス数をしきい値と照合して評価します
- Mail.Send (任意 — 機能: メールレポート)
  - メール配信が選択されている場合、Send-RjRbReportEmail を介してしきい値レポートのメールを送信します

権限に関する注意

Azure Storage Account: ターゲットの Storage Account に対する Automation Account のマネージド ID に 'Storage Account Contributor' ロールが必要です。アップロードでは listKeys を使用してアカウントキーを取得します（ダウンロードリンクのオプションでのみ必要）

パラメーター

InputJson

SKU の一覧を、わかりやすい名前と最小・最大しきい値付きで JSON 配列として。runbook customization に事前設定されています。

プロパティ

値

必須

true

既定値

種類

オブジェクト

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ReportFileFormat

レポートを CSV、Excel ブック、またはその両方として配信します。

プロパティ

値

必須

false

既定値

CSV と XLSX

種類

文字列

ポータルの表示名

レポートファイル形式

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ポータルオプション

ポータルオプション

値

CSV と XLSX

CSV のみ

XLSX のみ

CreateDownloadLink

また、レポートをアップロードし、数日後に期限切れになるダウンロードリンクを返します。

プロパティ

値

必須

false

既定値

False

種類

ブール値

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ContainerName

レポートファイルをアップロードするストレージコンテナー。runbook ごとに設定します。

プロパティ

値

必須

false

既定値

report-license-assignment

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ResourceGroupName

レポートアップロード用の Storage Account のリソースグループ。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得します。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

StorageAccountName

レポートアップロード用の Storage Account。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得します。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

LinkExpiryDays

ダウンロードリンクが有効なままの期間（日数）。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

プロパティ

値

必須

false

既定値

種類

Int32

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

SendEmailReport

レポートを宛先のメールアドレスに送信します。

プロパティ

値

必須

false

既定値

False

種類

ブール値

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

EmailTo

レポートをこれらの宛先に送信します。複数指定する場合はコンマで区切ってください。各受信者には個別のメールが送信されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルの表示名

受信者のメールアドレス

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

EmailFrom

レポートメールの送信元アドレス。Tenant 設定 RJReport.EmailSender から取得されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingHeaderImageUrl

レポートメールのヘッダー画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。Tenant 設定 RJReport.Branding.HeaderImageUrl から取得されます。空欄の場合は既定の RealmJoin ヘッダーが使用されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingFooterImageUrl

レポートメールのフッター画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。Tenant 設定 RJReport.Branding.FooterImageUrl から取得されます。空欄の場合は既定の RealmJoin フッターが使用されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingFooterLink

レポートメールのフッター画像のリンク先。Tenant 設定 RJReport.Branding.FooterLink から取得されます。空欄の場合は realmjoin.com が使用されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingAccentColor

レポートメールのアクセントカラー。6 桁の 16 進値で指定します。Tenant 設定 RJReport.Branding.AccentColor から取得されます。空欄または無効な場合は RealmJoin の既定値が使用されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingTextColor

レポートメールのテキストカラー。6 桁の 16 進値で指定します。Tenant 設定 RJReport.Branding.TextColor から取得されます。空欄または無効な場合は RealmJoin の既定値が使用されます。

プロパティ

値

必須

false

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

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

最終更新 3 日前

役に立ちましたか？