名前空間: 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 | 文字列 | センサーの表示名。 |
| domainName | 文字列 | センサーの完全修飾ドメイン名。 |
| healthStatus | microsoft.graph.security.sensorHealthStatus | センサーの正常性状態。 使用可能な値: healthy、notHealthyLow、notHealthyMedium、notHealthyHigh、unknownFutureValue。 |
| id | 文字列 | センサーを表す一意の識別子。 エンティティから継承 されます。 |
| migrationState | microsoft.graph.security.migrationState | センサーの移行状態。 使用可能な値: readyForMigration、notReadyForMigration、upToDate、migrationFailed、migrating、unknownFutureValue。 |
| openHealthIssuesCount | Int64 | このフィールドには、このセンサーに関連する正常性の問題の数が表示されます。 |
| sensorType | microsoft.graph.security.sensorType | センサーの種類。 使用可能な値: adConnectIntegrated、adcsIntegrated、adfsIntegrated、domainControllerIntegrated、domainControllerStandalone、unknownFutureValue。 |
| serviceStatus | microsoft.graph.security.serviceStatus | サービスの状態。 使用可能な値: stopped、starting、running、disabled、onboarding、unknown、unknownFutureValue。 |
| settings | microsoft.graph.security.sensorSettings | センサーの設定情報。 |
| version | 文字列 | センサーのバージョン。 |
deploymentStatus 値
| メンバー | 説明 |
|---|---|
| upToDate | センサーは、現在のバージョンのセンサーを実行しています。 |
| Outdated | センサーが実行しているソフトウェアは、現在のバージョンより少なくとも 3 つ遅れています。 |
| 更新中 | センサー ソフトウェアを更新中です。 |
| updateFailed | センサーを新しいバージョンに更新できませんでした。 |
| notConfigured | センサーを完全に動作させるには、さらに構成が必要です。 これは、ADFS および ADCS サーバーまたはスタンドアロン センサーにインストールされているセンサーに適用されます。 |
| 到達不能 | ドメイン コントローラが Active Directory から削除されました。 ただし、センサーのインストールは、使用停止になる前にアンインストールされず、ドメイン コントローラーから削除されませんでした。 このエントリは安全に削除できます。 |
| 切断済み | Defender for Identity サービスは、このセンサーからの通信を 10 分間確認していません。 |
| startFailure | センサーが 30 分間以上構成をプルしませんでした。 |
| 同期中 | センサーには構成の更新が保留中ですが、まだ新しい構成がプルされていません。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
sensorHealthStatus 値
| メンバー | 説明 |
|---|---|
| healthy | 未解決の正常性の問題はありません。 |
| notHealthyLow | 重大度が最も高いオープンな正常性の問題は [低] です。 |
| notHealthyMedium | 最も重大度の高いオープン正常性の問題は中です。 |
| notHealthyHigh | 重大度が最も高いオープン正常性の問題は [高] です。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
sensorType 値
| メンバー | 説明 |
|---|---|
| adConnectIntegrated | Entra Connect センサー。 |
| adcsIntegrated | Active Directory 証明書サービス (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)",
"migrationState": "String",
"openHealthIssuesCount": "Int64",
"sensorType": "String",
"settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
"version": "String",
"serviceStatus": "String"
}