windows10DeviceFirmwareConfigurationInterface erstellen
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
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 |
| Anwendung | 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 objekt windows10DeviceFirmwareConfigurationInterface an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von 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 entitätsbezogene instance. Geerbt von deviceConfiguration. |
| supportsScopeTags | Boolesch | 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 false ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dies tritt bei legacy-Richtlinien auf, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal aufgelöst werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die Anwendbarkeit der Betriebssystemedition für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die Anwendbarkeitsregel der Betriebssystemversion für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Die Anwendbarkeitsregel für den Gerätemodus 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 von UEFI-Einstellungen gewährt wird. Mögliche Werte sind: notConfiguredOnly und none. |
| virtualizationOfCpuAndIO | Ermöglichen | Definiert, ob die CPU- und E/A-Virtualisierung aktiviert ist. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Fotoapparate | Ermöglichen | Definiert, ob integrierte Kameras aktiviert sind. Mögliche Werte sind: notConfigured, enabled und disabled. |
| microphonesAndSpeakers | Ermöglichen | Definiert, ob integrierte Mikrofone oder Lautsprecher aktiviert sind. Mögliche Werte sind: notConfigured, enabled und disabled. |
| radios | Ermöglichen | Definiert, ob integrierte Funkgeräte wie WLAN, NFC, Bluetooth aktiviert sind. Mögliche Werte sind: notConfigured, enabled und disabled. |
| bootFromExternalMedia | Ermöglichen | Definiert, ob ein Benutzer von externen Medien starten darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| bootFromBuiltInNetworkAdapters | Ermöglichen | Definiert, ob ein Benutzer von integrierten Netzwerkadaptern starten darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| windowsPlatformBinaryTable | Ermöglichen | Definiert, ob ein Benutzer die Binäre Tabelle der Windows-Plattform aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| simultaneousMultiThreading | Ermöglichen | Definiert, ob ein Benutzer gleichzeitiges MultiThreading aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| frontCamera | Ermöglichen | Definiert, ob ein Benutzer die Frontkamera aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| rearCamera | Ermöglichen | Definiert, ob ein Benutzer die Rückfahrkamera aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| infrarotKamera | Ermöglichen | Definiert, ob ein Benutzer die Infrarotkamera aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Mikrofon | Ermöglichen | Definiert, ob ein Benutzer Mikrofon aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| Bluetooth | Ermöglichen | Definiert, ob ein Benutzer Bluetooth aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| wirelessWideAreaNetwork | Ermöglichen | Definiert, ob ein Benutzer drahtloses Wide Area Network aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| nearFieldCommunication | Ermöglichen | Definiert, ob ein Benutzer die Nahfeldkommunikation aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| WLAN | Ermöglichen | Definiert, ob ein Benutzer WLAN aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| usbTypeAPort | Ermöglichen | Definiert, ob ein Benutzer usb-Typ-A-Port aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| sdCard | Ermöglichen | Definiert, ob ein Benutzer den SD-Kartenport aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| wakeOnLAN | Ermöglichen | Definiert, ob ein Benutzer Wake on LAN aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
| wakeOnPower | Ermöglichen | Definiert, ob ein Benutzer Wake On Power aktivieren darf. Mögliche Werte sind: notConfigured, enabled und disabled. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und das Objekt windows10DeviceFirmwareConfigurationInterface im Antworttext zurückgegeben.
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"
}