deviceEnrollmentWindowsHelloForBusinessConfiguration-Ressourcentyp

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

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

mit Windows Hello for Business Einstellungen können Benutzer per Geste, z. B. biometrische Authentifizierung oder PIN, auf ihre Geräte zugreifen. Konfigurieren Sie Die 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 Geerbt von deviceEnrollmentConfiguration
displayName Zeichenfolge Der Anzeigename der Geräteregistrierungskonfiguration, geerbt von deviceEnrollmentConfiguration
description String Die Beschreibung der Geräteregistrierungskonfiguration, geerbt von deviceEnrollmentConfiguration
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 Erstellungsdatum der Konfiguration für die Geräteregistrierung in UTC, geerbt von deviceEnrollmentConfiguration
lastModifiedDateTime DateTimeOffset Datum der letzten Änderung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration
Version Int32 Die Version der Geräteregistrierungskonfiguration, geerbt von deviceEnrollmentConfiguration
roleScopeTagIds Zeichenfolgensammlung Optionale Rollenbereichstags für die Registrierungseinschränkungen. Geerbt von deviceEnrollmentConfiguration
deviceEnrollmentConfigurationType deviceEnrollmentConfigurationType Unterstützung für den Registrierungskonfigurationstyp, geerbt von deviceEnrollmentConfiguration. Mögliche Werte: unknown, limit, platformRestrictions, windowsHelloForBusiness, defaultLimit, defaultPlatformRestrictions, defaultWindowsHelloForBusiness, defaultWindows10EnrollmentCompletionPageConfiguration, windows10EnrollmentCompletionPageConfiguration, deviceComanagementAuthorityConfiguration, singlePlatformRestriction, unknownFutureValue, enrollmentNotificationsConfiguration.
pinMinimumLength Int32 Steuert die mindest erforderliche Anzahl von Zeichen für die Windows Hello for Business PIN. 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 maximal zulässige Anzahl von Zeichen für die Windows Hello for Business PIN. Dieser Wert muss zwischen 4 und 127 (einschließlich) liegen. Dieser Wert muss größer oder gleich dem Wert sein, der für die mindeste PIN festgelegt wurde.
pinUppercaseCharactersUsage windowsHelloForBusinessPinUsage Steuert die Möglichkeit, Großbuchstaben in der Windows Hello for Business-PIN zu verwenden. Zugelassen erlaubt die Verwendung von Großbuchstaben, während Required sicherstellt, dass sie vorhanden sind. Wenn dieser Wert 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. Zugelassen erlaubt die Verwendung von Kleinbuchstaben, während Required sicherstellt, dass sie vorhanden sind. Wenn dieser Wert auf "Nicht zulässig" festgelegt ist, sind Kleinbuchstaben nicht zulässig. Mögliche Werte sind: allowed, required und disallowed.
pinSpecialCharactersUsage windowsHelloForBusinessPinUsage Steuert die Verwendung von Sonderzeichen in der Windows Hello for Business PIN. Zugelassen erlaubt die Verwendung von Sonderzeichen, während Required sicherstellt, dass sie vorhanden sind. Wenn dieser Wert auf "Nicht zulässig" festgelegt ist, sind Sonderzeichen nicht zulässig. Mögliche Werte sind: allowed, required und disallowed.
Status Aktivierung Steuert, ob das Gerät für Windows Hello for Business konfiguriert werden kann. Wenn diese Option deaktiviert ist, kann der Benutzer keine Windows Hello for Business bereitstellen, es sei denn, dies ist auf mobiltelefonen mit Azure Active Directory verbunden, wenn dies andernfalls erforderlich ist. Wenn diese Einstellung auf "Nicht konfiguriert" festgelegt ist, überschreibt Intune die Clientstandardwerte nicht. Mögliche Werte sind: notConfigured, enabled und disabled.
securityDeviceRequired Boolean 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 Boolean 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 Boolean 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 an der Verwendung vergangener PINs zu hindern. Dieser Wert muss zwischen 0 und 50 (einschließlich) festgelegt werden, und die aktuelle PIN des Benutzers ist in dieser Anzahl enthalten. Bei Festlegung auf 0 werden vorherige PINs nicht gespeichert. Der PIN-Verlauf wird nicht durch eine PIN-Zurücksetzung beibehalten.
pinExpirationInDays Int32 Steuert den Zeitraum (in Tagen), in dem eine PIN verwendet werden kann, bevor das System vom Benutzer eine Änderung erfordert. Dieser Wert muss zwischen 0 und einschließlich 730 festgelegt werden. Bei Festlegung auf 0 läuft die PIN des Benutzers nie ab.
enhancedBiometricsState Aktivierung Steuert die Möglichkeit, die Antispoofingfeatures für die Gesichtserkennung auf Geräten zu verwenden, die dies unterstützen. Bei deaktivierter Einstellung sind Antispoofingfeatures nicht zulässig. Wenn dieser Wert auf "Nicht konfiguriert" festgelegt ist, kann der Benutzer auswählen, ob er Antispoofing verwenden möchte. Mögliche Werte sind: notConfigured, enabled und disabled.
securityKeyForSignIn Aktivierung Der Sicherheitsschlüssel für die Anmeldung bietet die Möglichkeit zum Remote-Aktivieren/Deaktivieren Windows Hello Sercurity Keyl Not configured berücksichtigt Konfigurationen, die im Clinet ausgeführt werden. Mögliche Werte sind: notConfigured, enabled und disabled.

Beziehungen

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

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,
  "roleScopeTagIds": [
    "String"
  ],
  "deviceEnrollmentConfigurationType": "String",
  "pinMinimumLength": 1024,
  "pinMaximumLength": 1024,
  "pinUppercaseCharactersUsage": "String",
  "pinLowercaseCharactersUsage": "String",
  "pinSpecialCharactersUsage": "String",
  "state": "String",
  "securityDeviceRequired": true,
  "unlockWithBiometricsEnabled": true,
  "remotePassportEnabled": true,
  "pinPreviousBlockCount": 1024,
  "pinExpirationInDays": 1024,
  "enhancedBiometricsState": "String",
  "securityKeyForSignIn": "String"
}