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
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"
}