Freigeben über


deviceEnrollmentWindowsHelloForBusinessConfiguration-Ressourcentyp

Namespace: microsoft.graph

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

Mithilfe der Windows Hello for Business-Einstellungen können Benutzer über eine Geste auf ihre Geräte zugreifen, z. B. die biometrische Authentifizierung oder eine 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 Zeichenfolge Eindeutiger Bezeichner für das Konto, das von deviceEnrollmentConfiguration geerbt wurde
displayName Zeichenfolge Der Anzeigename der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde.
description Zeichenfolge 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 Ermöglichen Steuert, ob das Gerät für Windows Hello for Business konfiguriert werden soll. Wenn diese Einstellung deaktiviert 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, überschreibt 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 von 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 auch dann bereitstellen, 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 Ermöglichen 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"
}