deviceEnrollmentWindowsHelloForBusinessConfiguration-Ressourcentyp

Artikel
03/26/2023

Namespace: microsoft.graph

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Windows Hello for Business Einstellungen ermöglichen Benutzern den Zugriff auf ihre Geräte mithilfe einer Geste, z. B. der biometrischen Authentifizierung oder einer PIN. Konfigurieren Sie Einstellungen für registrierte Windows 10, Windows 10 Mobile und höher.

Erbt von deviceEnrollmentConfiguration

Methoden

Methode	Rückgabetyp	Beschreibung
DeviceEnrollmentWindowsHelloForBusinessConfigurations auflisten	deviceEnrollmentWindowsHelloForBusinessConfiguration-Sammlung	Auflisten von Eigenschaften und Beziehungen der deviceEnrollmentWindowsHelloForBusinessConfiguration-Objekte.
DeviceEnrollmentWindowsHelloForBusinessConfiguration abrufen	deviceEnrollmentWindowsHelloForBusinessConfiguration	Lesen von Eigenschaften und Beziehungen des deviceEnrollmentWindowsHelloForBusinessConfiguration-Objekts.
DeviceEnrollmentWindowsHelloForBusinessConfiguration erstellen	deviceEnrollmentWindowsHelloForBusinessConfiguration	Erstellen eines neuen deviceEnrollmentWindowsHelloForBusinessConfiguration-Objekts.
DeviceEnrollmentWindowsHelloForBusinessConfiguration löschen	Keine	Löscht ein deviceEnrollmentWindowsHelloForBusinessConfiguration-Objekt.
DeviceEnrollmentWindowsHelloForBusinessConfiguration aktualisieren	deviceEnrollmentWindowsHelloForBusinessConfiguration	Aktualisieren der Eigenschaften eines deviceEnrollmentWindowsHelloForBusinessConfiguration-Objekts.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	String	Eindeutiger Bezeichner für das Konto, das von deviceEnrollmentConfiguration geerbt wurde
displayName	String	Der Anzeigename der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde.
description	String	Die Beschreibung der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde.
Priorität	Int32	Priorität wird verwendet, wenn ein Benutzer in mehreren Gruppen vorhanden ist, denen die Registrierungskonfiguration zugewiesen ist. Benutzer unterliegen nur der Konfiguration mit dem niedrigsten Prioritätswert. Geerbt von deviceEnrollmentConfiguration
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration
lastModifiedDateTime	DateTimeOffset	Datum der letzten Änderung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration
Version	Int32	Die Version der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde
pinMinimumLength	Int32	Steuert die Mindestanzahl von Zeichen, die für die Windows Hello for Business PIN erforderlich sind. Dieser Wert muss zwischen 4 und 127 (einschließlich) liegen und kleiner oder gleich dem für die maximale PIN festgelegten Wert sein.
pinMaximumLength	Int32	Steuert die maximale Anzahl von Zeichen, die für die Windows Hello for Business PIN zulässig sind. Dieser Wert muss zwischen 4 und einschließlich 127 liegen. Dieser Wert muss größer oder gleich dem wert sein, der für die minimale PIN festgelegt wurde.
pinUppercaseCharactersUsage	windowsHelloForBusinessPinUsage	Steuert die Möglichkeit, Großbuchstaben in der Windows Hello for Business PIN zu verwenden. Zulässig erlaubt die Verwendung von Großbuchstaben, während Erforderlich sicherstellt, dass sie vorhanden sind. Wenn auf Nicht zulässig festgelegt ist, sind Großbuchstaben nicht zulässig. Mögliche Werte sind: `allowed`, `required` und `disallowed`.
pinLowercaseCharactersUsage	windowsHelloForBusinessPinUsage	Steuert die Möglichkeit, Kleinbuchstaben in der Windows Hello for Business PIN zu verwenden. Zulässig erlaubt die Verwendung von Kleinbuchstaben, während Erforderlich sicherstellt, dass sie vorhanden sind. Wenn diese Einstellung auf Nicht zulässig festgelegt ist, sind Kleinbuchstaben nicht zulässig. Mögliche Werte sind: `allowed`, `required` und `disallowed`.
pinSpecialCharactersUsage	windowsHelloForBusinessPinUsage	Steuert die Möglichkeit, Sonderzeichen in der Windows Hello for Business-PIN zu verwenden. Zulässig erlaubt die Verwendung von Sonderzeichen, während Erforderlich sicherstellt, dass sie vorhanden sind. Wenn auf Nicht zulässig festgelegt ist, sind Sonderzeichen nicht zulässig. Mögliche Werte sind: `allowed`, `required` und `disallowed`.
state	Aktivierung	Steuert, ob das Gerät für Windows Hello for Business konfiguriert werden soll. Wenn deaktiviert festgelegt ist, kann der Benutzer Windows Hello for Business nur auf in Azure Active Directory eingebundenen Mobiltelefonen bereitstellen, wenn dies andernfalls erforderlich ist. Wenn diese Einstellung auf Nicht konfiguriert festgelegt ist, überschreiben Intune die Clientstandardeinstellungen nicht. Mögliche Werte sind: `notConfigured`, `enabled` und `disabled`.
securityDeviceRequired	Boolesch	Steuert, ob ein Trusted Platform Module (TPM) für die Bereitstellung Windows Hello for Business erforderlich ist. Ein TPM bietet einen zusätzlichen Sicherheitsvorteil, da darauf gespeicherte Daten nicht auf anderen Geräten verwendet werden können. Bei Festlegung auf False können alle Geräte Windows Hello for Business bereitstellen, auch wenn kein verwendbares TPM vorhanden ist.
unlockWithBiometricsEnabled	Boolesch	Steuert die Verwendung biometrischer Gesten wie Gesicht und Fingerabdruck als Alternative zur Windows Hello for Business PIN. Bei Festlegung auf False sind biometrische Gesten nicht zulässig. Benutzer müssen im Falle von Fehlern weiterhin eine PIN als Sicherung konfigurieren.
remotePassportEnabled	Boolesch	Steuert die Verwendung von Remote Windows Hello for Business. Remote Windows Hello for Business bietet die Möglichkeit, dass ein tragbares, registriertes Gerät als Begleiter für die Desktopauthentifizierung verwendet werden kann. Der Desktop muss in Azure AD eingebunden sein, und das Begleitgerät muss über eine Windows Hello for Business-PIN verfügen.
pinPreviousBlockCount	Int32	Steuert die Möglichkeit, Benutzer daran zu hindern, frühere PINs zu verwenden. Dies muss zwischen 0 und 50 (einschließlich) festgelegt werden, und die aktuelle PIN des Benutzers ist in dieser Anzahl enthalten. Wenn dieser Wert auf 0 festgelegt ist, werden vorherige PINs nicht gespeichert. Der PIN-Verlauf wird durch eine PIN-Zurücksetzung nicht beibehalten.
pinExpirationInDays	Int32	Steuert den Zeitraum (in Tagen), in dem eine PIN verwendet werden kann, bevor das System vom Benutzer verlangt, sie zu ändern. Dies muss zwischen 0 und 730 (einschließlich) festgelegt werden. Wenn diese Einstellung auf 0 festgelegt ist, läuft die PIN des Benutzers nie ab.
enhancedBiometricsState	Aktivierung	Steuert die Möglichkeit, die Anti-Spoofing-Features für die Gesichtserkennung auf Geräten zu verwenden, die sie unterstützen. Wenn diese Einstellung deaktiviert ist, sind Antispoofingfeatures nicht zulässig. Wenn die Einstellung Nicht konfiguriert festgelegt ist, kann der Benutzer auswählen, ob er Antispoofing verwenden möchte. Mögliche Werte sind: `notConfigured`, `enabled` und `disabled`.

Beziehungen

Beziehung	Typ	Beschreibung
assignments	enrollmentConfigurationAssignment-Sammlung	Die Liste der Gruppenzuweisungen für das Gerätekonfigurationsprofil, das von deviceEnrollmentConfiguration geerbt wurde

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.deviceEnrollmentWindowsHelloForBusinessConfiguration",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "priority": 1024,
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "version": 1024,
  "pinMinimumLength": 1024,
  "pinMaximumLength": 1024,
  "pinUppercaseCharactersUsage": "String",
  "pinLowercaseCharactersUsage": "String",
  "pinSpecialCharactersUsage": "String",
  "state": "String",
  "securityDeviceRequired": true,
  "unlockWithBiometricsEnabled": true,
  "remotePassportEnabled": true,
  "pinPreviousBlockCount": 1024,
  "pinExpirationInDays": 1024,
  "enhancedBiometricsState": "String"
}