次の方法で共有

alertRule リソースの種類

名前空間: 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、unknownFutureValue、cloudPcInGracePeriodScenario、cloudPcFrontlineInsufficientLicensesScenario、cloudPcInaccessibleScenario、cloudPcFrontlineConcurrencyScenario、cloudPcUserSettingsPersistenceScenario、cloudPcDeprovisionFailedScenario。 Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。cloudPcInGracePeriodScenario、cloudPcFrontlineInsufficientLicensesScenario、cloudPcInaccessibleScenario、cloudPcFrontlineConcurrencyScenario、cloudPcUserSettingsPersistenceScenario、cloudPcDeprovisionFailedScenario。
説明 String ルールの説明。
displayName String ルールの表示名。
enabled ブール型 ルールが有効か無効かを示すルールの状態。 true場合、ルールは有効になります。それ以外の場合、ルールは無効になります。
id 文字列 アラート ルールの一意識別子。 エンティティから継承 されます。
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 が接続できなかったときにトリガーされました。 または、デバイスの状態をプロビジョニングまたは復元中であったためです。
cloudPcFrontlineConcurrencyScenario Frontline Cloud PC のコンカレンシー使用量のすべての条件に対してアラート ルールがトリガーされたことを示します。 これには、現在のバッファーの使用条件が含まれています。
cloudPcUserSettingsPersistenceScenario アラート ルールが、使用が定義された制限またはしきい値に達した Frontline Cloud PC ユーザー エクスペリエンス同期ストレージ シナリオに関連付けられていることを示します。
cloudPcDeprovisionFailedScenario クラウド 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"
  },
  "conditions": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
    }
  ]
}
  • Last updated on