alertRule リソースの種類

[アーティクル]
11/18/2023

名前空間: microsoft.graph.deviceManagement

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

適切なロールを持つ IT 管理者が、Microsoft エンドポイントマネージャー管理センターで問題を監視し、アラートをトリガーするように構成できるルールを表します。

alertRule のしきい値に達すると、alertRecord が生成されて格納され、管理者は定義済みの通知チャネルを介して通知を受け取ります。

詳細については、監視リソースに関するページを参照してください。

注:

この API は、現在、Windows 365とクラウド PC のシナリオのみをサポートするアラート監視 API セットの一部です。 API セットを使用すると、管理者は、クラウド PC のプロビジョニング、クラウド PC イメージのアップロード、Azure ネットワーク接続の確認に関する問題を警告するルールを設定できます。

Microsoft エンドポイントマネージャー管理センターでプログラムによる追加のアラートサポートを使用できる別のシナリオがありますか? 機能を提案するか、既存の機能要求に投票します。

メソッド	戻り値の種類	説明
alertRules を一覧表示する	microsoft.graph.deviceManagement.alertRule コレクション	alertRule オブジェクトとそのプロパティの一覧を取得します。
alertRule を作成する	microsoft.graph.deviceManagement.alertRule	alertRule オブジェクトを作成します。
alertRule を取得する	microsoft.graph.deviceManagement.alertRule	alertRule オブジェクトのプロパティとリレーションシップを読み取ります。
alertRule を更新する	microsoft.graph.deviceManagement.alertRule	alertRule オブジェクトのプロパティを更新します。

プロパティ

プロパティ	型	説明
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	アラートイベントのルールテンプレート。使用可能な値: `cloudPcProvisionScenario`、`cloudPcImageUploadScenario`、`cloudPcOnPremiseNetworkConnectionCheckScenario`、`cloudPcInGracePeriodScenario`、`cloudPcFrontlineInsufficientLicensesScenario`、`cloudPcInaccessibleScenario`。この進化可能な列挙型から次の`Prefer: include-unknown-enum-members`値を取得するには、要求ヘッダーを使用する必要があることに注意してください。 `cloudPcInGracePeriodScenario`
説明	String	ルールの説明。
displayName	String	ルールの表示名。
enabled	ブール型	ルールが有効か無効かを示すルールの状態。の場合 `true`、ルールが有効になっています。それ以外の場合、ルールは無効になります。
id	String	アラートルールの一意識別子。エンティティから継承されます。
isSystemRule	ブール型	ルールがシステムルールであるかどうかを示します。の場合 `true`、ルールはシステムルールです。それ以外の場合、ルールはカスタム定義ルールであり、編集できます。システムルールは組み込まれており、編集できるプロパティはごくわずかです。
notificationChannels	microsoft.graph.deviceManagement.notificationChannel コレクション	ユーザーが選択したルールの通知チャネル。
severity	microsoft.graph.deviceManagement.ruleSeverityType	ルールの重大度。使用可能な値: `unknown`、`informational`、`warning`、`critical`、`unknownFutureValue`。
しきい値	microsoft.graph.deviceManagement.ruleThreshold	アラートを送信するタイミングを決定する条件。たとえば、6 台以上のクラウド PC でプロビジョニングが失敗したときにアラートを送信する条件を構成できます。このプロパティは推奨されていません。代わりに条件を使用してください。
conditions	microsoft.graph.deviceManagement.ruleCondition コレクション	アラートを送信するタイミングを決定する条件。たとえば、6 台以上のクラウド PC でプロビジョニングが失敗したときにアラートを送信する条件を構成できます。

alertRuleTemplate 値

メンバー	説明
cloudPcProvisionScenario	クラウド PC プロビジョニングに関する問題に対してアラートルールがトリガーされました。システムルールの場合、クラウド PC プロビジョニングエラーに対してアラートルールがトリガーされました。
cloudPcImageUploadScenario	クラウド PC イメージをアップロードするプロセスに関する問題に対してアラートルールがトリガーされました。システムルールの場合、クラウド PC イメージのアップロードに失敗した場合にアラートルールがトリガーされました。
cloudPcOnPremiseNetworkConnectionCheckScenario	オンプレミスネットワーク接続チェックに関する問題に対してアラートルールがトリガーされました。システムルールの場合、オンプレミスのネットワーク接続で障害が発生した場合にアラートルールがトリガーされました。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。
cloudPcInGracePeriodScenario	クラウド PC が猶予期間に入ったときにアラートルールがトリガーされました。
cloudPcFrontlineInsufficientLicensesScenario	このアラートルールは、同時実行制限よりも多くのコンカレントクラウド PC 接続がアクティブであった Frontline Cloud PC に対してトリガーされました。
cloudPcInaccessibleScenario	アラートルールは、ホストの正常性エラー、接続エラー、またはゾーンの停止のためにクラウド PC が接続できなかったときにトリガーされました。または、デバイスの状態をプロビジョニングまたは復元中であったためです。

ruleSeverityType 値

メンバー	説明
不明	重大度レベルはです `unknown`。初期化に使用されます。
情報	重大度レベルはです `informational`。
warning	重大度レベルはです `warning`。
critical	重大度レベルはです `critical`。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.deviceManagement.alertRule",
  "alertRuleTemplate": "String",  
  "description": "String",
  "displayName": "String",
  "enabled": "Boolean",
  "id": "String (identifier)",
  "isSystemRule": "Boolean",
  "notificationChannels": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.notificationChannel"
    }
  ], 
  "severity": "String",
  "threshold": {
    "@odata.type": "microsoft.graph.deviceManagement.ruleThreshold"
  },
  "condition": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
    }
  ]
}