Sensorressourcentyp

Namespace: microsoft.graph.security

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt einen Microsoft Defender for Identity Sensor dar.

Erbt von microsoft.graph.entity.

Methoden

Methode	Rückgabetyp	Beschreibung
List	microsoft.graph.security.sensor collection	Rufen Sie eine Liste der microsoft.graph.security.sensor-Objekte und deren Eigenschaften ab.
Get	microsoft.graph.security.sensor	Lesen der Eigenschaften und Beziehungen eines microsoft.graph.security.sensor-Objekts .
Update	microsoft.graph.security.sensor	Aktualisieren Sie die Eigenschaften eines microsoft.graph.security.sensor-Objekts .
Delete	Keine	Löschen Sie ein microsoft.graph.security.sensor-Objekt .
Abrufen des Bereitstellungspaket-URI	microsoft.graph.security.sensorDeploymentPackage	Rufen Sie die URL und Version des Sensorbereitstellungspakets ab. Sie können diese URL verwenden, um das Installationsprogramm herunterzuladen, um den Sensor auf einem Server zu installieren.
Abrufen des Bereitstellungszugriffsschlüssels	microsoft.graph.security.deploymentAccessKeyType	Rufen Sie den Bereitstellungszugriffsschlüssel ab, der dem Microsoft Defender for Identity Arbeitsbereich zugeordnet ist, der zum Installieren der dem Arbeitsbereich zugeordneten Sensoren erforderlich ist.
Erneutes Generieren des Bereitstellungszugriffsschlüssels	microsoft.graph.security.deploymentAccessKeyType	Generieren Sie einen neuen Bereitstellungszugriffsschlüssel, der zum Installieren von Sensoren verwendet werden kann, die dem Arbeitsbereich zugeordnet sind.

Eigenschaften

Eigenschaft	Typ	Beschreibung
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Sensorgenerierung.
deploymentStatus	microsoft.graph.security.deploymentStatus	Die Bereitstellung status des Sensors. Mögliche Werte sind: upToDate, outdated, updating, updateFailed, notConfigured, unreachable, disconnected, startFailure, syncing, unknownFutureValue.
displayName	String	Der Anzeigename des Sensors.
Domänname	String	Der vollqualifizierte Domänenname des Sensors.
healthStatus	microsoft.graph.security.sensorHealthStatus	Die integritäts-status des Sensors. Mögliche Werte sind: healthy, notHealthyLow, notHealthyMedium, notHealthyHigh, unknownFutureValue.
ID	String	Eindeutiger Bezeichner zur Darstellung des Sensors.
openHealthIssuesCount	Int64	In diesem Feld wird die Anzahl der Integritätsprobleme im Zusammenhang mit diesem Sensor angezeigt.
sensorType	microsoft.graph.security.sensorType	Der Typ des Sensors. Mögliche Werte sind: adConnectIntegrated, adcsIntegrated, adfsIntegrated, domainControllerIntegrated, domainControllerStandalone, unknownFutureValue.
settings	microsoft.graph.security.sensorSettings	Sensoreinstellungsinformationen.
Version	String	Die Version des Sensors.

deploymentStatus-Werte

Member	Beschreibung
upToDate	Der Sensor führt eine aktuelle Version des Sensors aus.
überholt	Der Sensor führt eine Version der Software aus, die mindestens drei Versionen hinter der aktuellen Version aufweist.
Aktualisierung	Sensorsoftware wird aktualisiert.
updateFailed	Der Sensor konnte nicht auf eine neue Version aktualisiert werden.
notConfigured	Der Sensor erfordert mehr Konfiguration, bevor er vollständig betriebsbereit ist. Dies gilt für Sensoren, die auf AD FS-/AD CS-Servern oder eigenständigen Sensoren installiert sind.
unerreichbar	Der Domänencontroller wurde aus Active Directory gelöscht. Die Sensorinstallation wurde jedoch nicht deinstalliert und vom Domänencontroller entfernt, bevor er außer Betrieb genommen wurde. Sie können diesen Eintrag sicher löschen.
entfernt	Der Defender for Identity-Dienst hat in 10 Minuten keine Kommunikation von diesem Sensor gesehen.
startFailure	Der Sensor hat die Konfiguration länger als 30 Minuten nicht pullt.
zeitlich übereinstimmend	Für den Sensor stehen Konfigurationsupdates aus, die neue Konfiguration wurde jedoch noch nicht abgerufen.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

sensorHealthStatus-Werte

Member	Beschreibung
gesund	Keine geöffneten Integritätsprobleme.
notHealthyLow	Der höchste Schweregrad des geöffneten Integritätsproblems ist niedrig.
notHealthyMedium	Der höchste Schweregrad des geöffneten Integritätsproblems ist mittel.
notHealthyHigh	Der höchste Schweregrad des geöffneten Integritätsproblems ist hoch.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

sensorType-Werte

Member	Beschreibung
adConnectIntegrated	Entra Connect-Sensor.
adcsIntegrated	AdCS-Sensor (Active Directory Certificate Services).
adfsIntegrated	Active Directory-Verbunddienste (AD FS)-Sensor (AD FS).
domainControllerIntegrated	Domänencontrollersensor.
domainControllerStandalone	Eigenständiger Sensor.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Beziehung	Typ	Beschreibung
healthIssues	microsoft.graph.security.healthIssue-Sammlung	Stellt potenzielle Probleme innerhalb der Microsoft Defender for Identity-Konfiguration eines Kunden dar, die im Zusammenhang mit dem Sensor identifiziert Microsoft Defender for Identity.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.security.sensor",
  "id": "String (identifier)",
  "displayName": "String",
  "sensorType": "String",
  "version": "String",
  "deploymentStatus": "String",
  "createdDateTime": "String (timestamp)",
  "domainName": "String",
  "healthStatus": "String",
  "openHealthIssuesCount": "Integer",
  "settings": {
    "@odata.type": "microsoft.graph.security.sensorSettings"
  }
}