Ressourcentyp des Sensors

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-Sammlung Rufen Sie eine Liste der Sensorobjekte und ihrer Eigenschaften ab.
Get microsoft.graph.security.sensor Lesen Sie die 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 Arbeitsbereich von Microsoft Defender for Identity zugeordnet ist. Er ist erforderlich, um die mit dem Arbeitsbereich verknüpften Sensoren zu installieren.
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 verwendet werden kann, um Sensoren zu installieren, die dem Arbeitsbereich zugeordnet sind.

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Sensor generiert wurde. Der Zeitstempel stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
deploymentStatus microsoft.graph.security.deploymentStatus Der Bereitstellungs-Status des Sensors. Mögliche Werte sind: upToDate, outdated, updating, updateFailed, notConfigured, unreachable, disconnected, startFailure, syncing, unknownFutureValue.
displayName Zeichenfolge Der Anzeigename des Sensors.
Domänname Zeichenfolge Der vollqualifizierte Domänenname des Sensors.
healthStatus microsoft.graph.security.sensorHealthStatus Der Status des Sensors. Mögliche Werte sind: healthy, notHealthyLow, notHealthyMedium, notHealthyHigh, unknownFutureValue.
id Zeichenfolge Eindeutiger Bezeichner zur Darstellung des Sensors. Geerbt von entity.
migrationState microsoft.graph.security.migrationState Der Migrationsstatus des Sensors. Mögliche Werte sind: readyForMigration, notReadyForMigration, upToDate, migrationFailed, migrating, unknownFutureValue.
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.
serviceStatus microsoft.graph.security.serviceStatus Der Dienst-Status. Mögliche Werte sind: stopped, starting, running, disabled, onboarding, unknown, unknownFutureValue.
settings microsoft.graph.security.sensorSettings Informationen zu Sensoreinstellungen.
Version Zeichenfolge Die Version des Sensors.

deploymentStatus-Werte

Member Beschreibung
upToDate Auf dem Sensor wird eine aktuelle Version des Sensors ausgeführt.
VERALTET Auf dem Sensor wird eine Softwareversion ausgeführt, die mindestens drei Versionen hinter der aktuellen Version liegt.
wird aktualisiert Die Sensorsoftware wird aktualisiert.
UpdateFailed Der Sensor konnte nicht auf eine neue Version aktualisiert werden.
nicht konfiguriert Der Sensor muss weiter konfiguriert werden, bevor er voll funktionsfähig ist. Dies gilt für Sensoren, die auf ADFS- und ADCS-Servern oder eigenständigen Sensoren installiert sind.
Nicht erreichbar Der Domänencontroller wurde aus Active Directory gelöscht. Die Sensorinstallation wurde jedoch vor der Außerbetriebnahme nicht deinstalliert und vom Domänencontroller entfernt. Diesen Eintrag können Sie sicher löschen.
Getrennt Der Defender for Identity-Dienst hat seit 10 Minuten keine Kommunikation von diesem Sensor empfangen.
startFailure Der Sensor konnte die Konfiguration länger als 30 Minuten nicht abrufen.
Wird synchronisiert Für den Sensor sind Konfigurationsupdates anstehen, aber die neue Konfiguration wurde noch nicht übertragen.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

sensorHealthStatus-Werte

Member Beschreibung
Fehlerfrei Keine geöffneten Integritätsprobleme.
notHealthyLow Das Problem mit dem höchsten Schweregrad der geöffneten Integrität ist niedrig.
notHealthyMedium Der höchste Schweregrad eines geöffneten Integritätsproblems hat den mittleren Schweregrad.
notHealthyHigh Der höchste Schweregrad, ein geöffnetes Integritätsproblem hat einen hohen Schweregrad.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

sensorType-Werte

Member Beschreibung
adConnectIntegrated Entra Connect Sensor.
adcsIntegrated ADCS-Sensor (Active Directory Certificate Services).
adfsIntegrated Sensor für Active Directory-Verbunddienste (AD FS).
domainControllerIntegrated Domänencontroller-Sensor.
domainControllerStandalone Eigenständiger Sensor.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Beziehungen

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

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)",
  "migrationState": "String",
  "openHealthIssuesCount": "Int64",
  "sensorType": "String",
  "settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
  "version": "String",
  "serviceStatus": "String"
}
  • Last updated on