Sensorressourcentyp

Artikel
11/05/2024

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 entity.

Methoden

Methode	Rückgabetyp	Beschreibung
List	microsoft.graph.security.sensor collection	Ruft eine Liste der Sensorobjekte und deren Eigenschaften ab.
Get	microsoft.graph.security.sensor	Lesen der Eigenschaften und Beziehungen eines Sensorobjekts .
Update	microsoft.graph.security.sensor	Aktualisieren sie die Eigenschaften eines Sensorobjekts .
Löschen	Keine	Löschen eines Sensorobjekts .
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.
Abrufen des Bereitstellungspaket-URI	microsoft.graph.security.sensorDeploymentPackage	Rufen Sie die URL und Version des Sensorbereitstellungspakets ab.
Bereitstellungszugriffsschlüssel neu generieren	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. Der Zeitstempel stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
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. Geerbt von entity.
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 ADDFS- und ADCS-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",
  "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"
}

Freigeben über