名前空間: microsoft.graph.security
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Defender for Identity センサーを表します。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | microsoft.graph.security.sensor コレクション | センサー オブジェクトとそのプロパティの一覧を取得します。 |
| Get | microsoft.graph.security.sensor | センサー オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | microsoft.graph.security.sensor | センサー オブジェクトのプロパティを更新します。 |
| Delete | なし | センサー オブジェクトを削除します。 |
| デプロイ アクセス キーを取得する | microsoft.graph.security.deploymentAccessKeyType | ワークスペースに関連付けられているセンサーをインストールするために必要な、Microsoft Defender for Identity ワークスペースに関連付けられているデプロイ アクセス キーを取得します。 |
| デプロイ パッケージ URI を取得する | microsoft.graph.security.sensorDeploymentPackage | センサーデプロイ パッケージの URL とバージョンを取得します。 |
| デプロイ アクセス キーを再生成する | microsoft.graph.security.deploymentAccessKeyType | ワークスペースに関連付けられているセンサーをインストールするために使用できる新しいデプロイ アクセス キーを生成します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| createdDateTime | DateTimeOffset | センサーが生成された日時。 タイムスタンプは、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC で表されます。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| deploymentStatus | microsoft.graph.security.deploymentStatus | センサーの展開状態。 使用可能な値: upToDate、outdated、updating、updateFailed、notConfigured、unreachable、disconnected、startFailure、syncing、unknownFutureValue。 |
| displayName | String | センサーの表示名。 |
| domainName | String | センサーの完全修飾ドメイン名。 |
| healthStatus | microsoft.graph.security.sensorHealthStatus | センサーの正常性状態。 使用可能な値: healthy、notHealthyLow、notHealthyMedium、notHealthyHigh、unknownFutureValue。 |
| id | String | センサーを表す一意の識別子。 エンティティから継承 されます。 |
| openHealthIssuesCount | Int64 | このフィールドには、このセンサーに関連する正常性の問題の数が表示されます。 |
| sensorType | microsoft.graph.security.sensorType | センサーの種類。 使用可能な値: adConnectIntegrated、adcsIntegrated、adfsIntegrated、domainControllerIntegrated、domainControllerStandalone、unknownFutureValue。 |
| settings | microsoft.graph.security.sensorSettings | センサー設定情報。 |
| version | String | センサーのバージョン。 |
deploymentStatus 値
| メンバー | 説明 |
|---|---|
| upToDate | センサーは、現在のバージョンのセンサーを実行しています。 |
| 時代遅れ | センサーは、現在のバージョンより少なくとも 3 つのバージョンのソフトウェアを実行しています。 |
| 更新 | センサー ソフトウェアが更新されています。 |
| updateFailed | センサーが新しいバージョンに更新できませんでした。 |
| notConfigured | センサーを完全に動作させるには、より多くの構成が必要です。 これは、ADFS および ADCS サーバーまたはスタンドアロン センサーにインストールされているセンサーに適用されます。 |
| 到達 不能 | ドメイン コントローラーが Active Directory から削除されました。 ただし、使用を停止する前に、センサーのインストールがアンインストールされ、ドメイン コントローラーから削除されませんでした。 このエントリは安全に削除できます。 |
| 途切れ途切れ | Defender for Identity サービスでは、このセンサーからの通信が 10 分で確認されていません。 |
| startFailure | センサーは 30 分以上構成をプルしませんでした。 |
| 同期 | センサーには構成の更新が保留中ですが、新しい構成はまだプルされていませんでした。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
sensorHealthStatus 値
| メンバー | 説明 |
|---|---|
| 元気 | 開かれた正常性の問題はありません。 |
| notHealthyLow | 最も重大度の高い開かれた正常性の問題は低いです。 |
| notHealthyMedium | 最も重大度の高い開かれた正常性の問題は中程度です。 |
| notHealthyHigh | 重大度が最も高い開かれた正常性の問題は高いです。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
sensorType 値
| メンバー | 説明 |
|---|---|
| adConnectIntegrated | Entra Connect センサー。 |
| adcsIntegrated | Active Directory Certificate Services (ADCS) センサー。 |
| adfsIntegrated | Active Directory フェデレーション サービス (AD FS) (ADFS) センサー。 |
| domainControllerIntegrated | ドメイン コントローラー センサー。 |
| domainControllerStandalone | スタンドアロン センサー。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| healthIssues | microsoft.graph.security.healthIssue コレクション | センサーに関連して特定Microsoft Defender for Identity顧客のMicrosoft Defender for Identity構成内の潜在的な問題を表します。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.security.sensor",
"createdDateTime": "String (timestamp)",
"deploymentStatus": "String",
"displayName": "String",
"domainName": "String",
"healthStatus": "String",
"id": "String (identifier)",
"openHealthIssuesCount": "Int64",
"sensorType": "String",
"settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
"version": "String"
}