Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig: Microsoft unterstützt Intune /beta-APIs, sie unterliegen jedoch häufigeren Änderungen. Microsoft empfiehlt, wenn möglich Version v1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version v1.0 mithilfe der Versionsauswahl.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Erstellen Sie ein neues windows10DeviceFirmwareConfigurationInterface-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementConfiguration.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Application | DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das Windows10DeviceFirmwareConfigurationInterface-Objekt an.
Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen der windows10DeviceFirmwareConfigurationInterface erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Schlüssel der Entität Geerbt von deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration. |
| roleScopeTagIds | String collection | Liste der Bereichstags für diese Entity instance. Geerbt von deviceConfiguration. |
| supportsScopeTags | Boolean | Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Die Zuweisung zur ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert falsch ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dieses Problem tritt bei Legacyrichtlinien auf, die in Silverlight erstellt wurden, und kann behoben werden, indem die Richtlinie gelöscht und im Azure-Portal neu erstellt wird. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die für diese Richtlinie geltende Betriebssystemedition. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die für diese Richtlinie geltende Regel zur Versionsanwendbarkeit. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Die Gerätemodus-Anwendbarkeitsregel für diese Richtlinie. Geerbt von deviceConfiguration. |
| createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration. |
| description | String | Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
| displayName | String | Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
| Version | Int32 | Version der Gerätekonfiguration. Geerbt von deviceConfiguration. |
| changeUefiSettingsPermission | changeUefiSettingsPermission | Definiert die Berechtigungsstufe, die Benutzern zum Ändern der UEFI-Einstellungen gewährt wird. Mögliche Werte sind: notConfiguredOnly und none. |
| virtualizationOfCpuAndIO | Aktivierung | Definiert, ob CPU- und E/A-Virtualisierung aktiviert ist. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Kameras | Aktivierung | Definiert, ob integrierte Kameras aktiviert sind. Mögliche Werte sind: notConfigured, enabled und disabled. |
| MikrofoneUndLautsprecher | Aktivierung | Definiert, ob integrierte Mikrofone oder Lautsprecher aktiviert sind. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Funkgeräte | Aktivierung | Definiert, ob integrierte Funkgeräte, z. B. WLAN, NFC, Bluetooth, aktiviert sind. Mögliche Werte sind: notConfigured, enabled und disabled. |
| bootFromExternalMedia | Aktivierung | Definiert, ob ein Benutzer von externen Medien starten darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| bootFromBuiltInNetworkAdapters | Aktivierung | Definiert, ob ein Benutzer von integrierten Netzwerkadaptern starten darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| windowsPlatformBinaryTable | Aktivierung | Definiert, ob ein Benutzer die Windows-Plattform-Binärtabelle aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| simultanesMultiThreading | Aktivierung | Definiert, ob ein Benutzer simultanes Multithreading aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| frontKamera | Aktivierung | Definiert, ob ein Benutzer die Frontkamera aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Rückfahrkamera | Aktivierung | Definiert, ob ein Benutzer die Rückfahrkamera aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Infrarot-Kamera | Aktivierung | Definiert, ob ein Benutzer die Infrarotkamera aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Mikrofon | Aktivierung | Definiert, ob ein Benutzer das Mikrofon aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Bluetooth | Aktivierung | Definiert, ob ein Benutzer Bluetooth aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| wirelessWideAreaNetwork | Aktivierung | Definiert, ob ein Benutzer Drahtloses Wide Area Network aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| nearFieldCommunication | Aktivierung | Definiert, ob ein Benutzer die Near Field Communication aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| WLAN | Aktivierung | Definiert, ob ein Benutzer WLAN aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| usbTypeAPort | Aktivierung | Definiert, ob ein Benutzer den USB-Typ-A-Anschluss aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| sdCard | Aktivierung | Definiert, ob ein Benutzer den SD-Karten-Anschluss aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| wakeOnLAN | Aktivierung | Definiert, ob ein Benutzer Wake-on-LAN aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| wakeOnPower | Aktivierung | Definiert, ob ein Benutzer "Wake On Power" aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein windows10DeviceFirmwareConfigurationInterface-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 1754
{
"@odata.type": "#microsoft.graph.windows10DeviceFirmwareConfigurationInterface",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"changeUefiSettingsPermission": "none",
"virtualizationOfCpuAndIO": "enabled",
"cameras": "enabled",
"microphonesAndSpeakers": "enabled",
"radios": "enabled",
"bootFromExternalMedia": "enabled",
"bootFromBuiltInNetworkAdapters": "enabled",
"windowsPlatformBinaryTable": "enabled",
"simultaneousMultiThreading": "enabled",
"frontCamera": "enabled",
"rearCamera": "enabled",
"infraredCamera": "enabled",
"microphone": "enabled",
"bluetooth": "enabled",
"wirelessWideAreaNetwork": "enabled",
"nearFieldCommunication": "enabled",
"wiFi": "enabled",
"usbTypeAPort": "enabled",
"sdCard": "enabled",
"wakeOnLAN": "enabled",
"wakeOnPower": "enabled"
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1926
{
"@odata.type": "#microsoft.graph.windows10DeviceFirmwareConfigurationInterface",
"id": "96474363-4363-9647-6343-479663434796",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"changeUefiSettingsPermission": "none",
"virtualizationOfCpuAndIO": "enabled",
"cameras": "enabled",
"microphonesAndSpeakers": "enabled",
"radios": "enabled",
"bootFromExternalMedia": "enabled",
"bootFromBuiltInNetworkAdapters": "enabled",
"windowsPlatformBinaryTable": "enabled",
"simultaneousMultiThreading": "enabled",
"frontCamera": "enabled",
"rearCamera": "enabled",
"infraredCamera": "enabled",
"microphone": "enabled",
"bluetooth": "enabled",
"wirelessWideAreaNetwork": "enabled",
"nearFieldCommunication": "enabled",
"wiFi": "enabled",
"usbTypeAPort": "enabled",
"sdCard": "enabled",
"wakeOnLAN": "enabled",
"wakeOnPower": "enabled"
}