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
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Diese Methode erstellt ein neues Objekt des Typs windows81GeneralConfiguration.
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
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Annehmen | application/json |
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs „windows81GeneralConfiguration“ an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs „windows81GeneralConfiguration“ erstellen.
| 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. |
| 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. |
| accountsBlockAddingNonMicrosoftAccountEmail | Boolean | Gibt an, ob verhindert werden soll, dass der Benutzer E-Mail-Konten zu Geräten hinzufügt, die keinem Microsoft-Konto zugeordnet sind. |
| applyOnlyToWindows81 | Boolean | Wert, der angibt, ob die Richtlinie nur für Windows 8.1 gilt. Diese Eigenschaft ist schreibgeschützt. |
| browserBlockAutofill | Boolean | Gibt an, ob AutoAusfüllen blockiert werden soll. |
| browserBlockAutomaticDetectionOfIntranetSites | Boolean | Gibt an, ob die automatische Erkennung von Intranetwebsites blockiert werden soll. |
| browserBlockEnterpriseModeAccess | Boolean | Gibt an, ob der Zugriff im Unternehmensmodus blockiert werden soll. |
| browserBlockJavaScript | Boolean | Gibt an, ob verhindert werden soll, dass der Benutzer JavaScript verwendet. |
| browserBlockPlugins | Boolean | Gibt an, ob Plug-Ins blockiert werden sollen. |
| browserBlockPopups | Boolean | Gibt an, ob Popups blockiert werden sollen. |
| browserBlockSendingDoNotTrackHeader | Boolean | Gibt an, ob verhindert werden soll, dass der Benutzer die Kopfzeile „Do Not Track“ (nicht verfolgen) sendet. |
| browserBlockSingleWordEntryOnIntranetSites | Boolean | Gibt an, ob Einträge mit nur einem einzigen Wort auf Intranetwebsites blockiert werden sollen. |
| browserRequireSmartScreen | Boolean | Gibt an, ob der Benutzer den Smartscreenfilter verwenden muss. |
| browserEnterpriseModeSiteListLocation | String | Speicherort der Websiteliste für den Unternehmensmodus. Dies kann eine lokale Datei, ein lokales Netzwerk oder ein http-Speicherort sein. |
| browserInternetSecurityLevel | internetSiteSecurityLevel | Internetsicherheitsstufe. Mögliche Werte sind: userDefined, medium, mediumHigh, high. |
| browserIntranetSecurityLevel | siteSecurityLevel | Intranetsicherheitsstufe. Mögliche Werte sind: userDefined, low, mediumLow, medium, mediumHigh, high. |
| browserLoggingReportLocation | String | Speicherort des Protokollierungsberichts |
| browserRequireHighSecurityForRestrictedSites | Boolean | Gibt an, ob für eingeschränkte Websites die Sicherheitsstufe „Hoch“ zwingend ist. |
| browserRequireFirewall | Boolean | Gibt an, ob eine Firewall erforderlich ist. |
| browserRequireFraudWarning | Boolean | Gibt an, ob die Funktion zur Betrugswarnung erforderlich ist. |
| browserTrustedSitesSecurityLevel | siteSecurityLevel | Sicherheitsstufe für vertrauenswürdige Websites. Mögliche Werte sind: userDefined, low, mediumLow, medium, mediumHigh, high. |
| cellularBlockDataRoaming | Boolean | Gibt an, ob Datenroaming blockiert werden soll. |
| diagnosticsBlockDataSubmission | Boolean | Gibt an, ob die Übermittlung von Diagnosedaten blockiert werden soll. |
| passwordBlockPicturePasswordAndPin | Boolean | Gibt an, ob verhindert werden soll, dass der Benutzer einen Bildcode und eine PIN verwendet. |
| passwordExpirationDays | Int32 | Zeit bis zum Ablaufen des Kennworts in Tagen |
| passwordMinimumLength | Int32 | Mindestlänge des Kennworts |
| passwordMinutesOfInactivityBeforeScreenTimeout | Int32 | Zeitraum von Inaktivität in Minuten, bevor es zu einem Bildschirmtimeout kommt. |
| passwordMinimumCharacterSetCount | Int32 | Anzahl der Zeichensätze, die im Kennwort enthalten sein müssen. |
| passwordPreviousPasswordBlockCount | Int32 | Grenze für die Wiederverwendung von Kennwörtern. Der festgelegte Wert gibt an, von wie vielen der zuletzt genutzten Kennwörter sich das Kennwort unterscheiden muss. Gültige Werte: 0 bis 24. |
| passwordRequiredType | requiredPasswordType | Geforderter Kennworttyp. Die möglichen Werte sind: deviceDefault, alphanumeric, numeric. |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | Die Anzahl von fehlgeschlagenen Anmeldeversuchen, bevor eine Zurücksetzung auf die Werkseinstellungen durchgeführt wird. |
| storageRequireDeviceEncryption | Boolean | Gibt an, ob für ein Mobilgerät Verschlüsselung gefordert wird. |
| updatesRequireAutomaticUpdates | Boolean | Gibt an, ob automatische Updates erforderlich sind. |
| userAccountControlSettings | windowsUserAccountControlSettings | Einstellungen der Benutzerkontensteuerung. Mögliche Werte sind: userDefined, alwaysNotify, notifyOnAppChanges, notifyOnAppChangesWithoutDimming, neverNotify. |
| workFoldersUrl | String | URL des Arbeitsordners. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created und ein Objekt des Typs windows81GeneralConfiguration im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 1693
{
"@odata.type": "#microsoft.graph.windows81GeneralConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"accountsBlockAddingNonMicrosoftAccountEmail": true,
"applyOnlyToWindows81": true,
"browserBlockAutofill": true,
"browserBlockAutomaticDetectionOfIntranetSites": true,
"browserBlockEnterpriseModeAccess": true,
"browserBlockJavaScript": true,
"browserBlockPlugins": true,
"browserBlockPopups": true,
"browserBlockSendingDoNotTrackHeader": true,
"browserBlockSingleWordEntryOnIntranetSites": true,
"browserRequireSmartScreen": true,
"browserEnterpriseModeSiteListLocation": "Browser Enterprise Mode Site List Location value",
"browserInternetSecurityLevel": "medium",
"browserIntranetSecurityLevel": "low",
"browserLoggingReportLocation": "Browser Logging Report Location value",
"browserRequireHighSecurityForRestrictedSites": true,
"browserRequireFirewall": true,
"browserRequireFraudWarning": true,
"browserTrustedSitesSecurityLevel": "low",
"cellularBlockDataRoaming": true,
"diagnosticsBlockDataSubmission": true,
"passwordBlockPicturePasswordAndPin": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordMinimumCharacterSetCount": 0,
"passwordPreviousPasswordBlockCount": 2,
"passwordRequiredType": "alphanumeric",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"storageRequireDeviceEncryption": true,
"updatesRequireAutomaticUpdates": true,
"userAccountControlSettings": "alwaysNotify",
"workFoldersUrl": "https://example.com/workFoldersUrl/"
}
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: 1865
{
"@odata.type": "#microsoft.graph.windows81GeneralConfiguration",
"id": "0e9285b5-85b5-0e92-b585-920eb585920e",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"accountsBlockAddingNonMicrosoftAccountEmail": true,
"applyOnlyToWindows81": true,
"browserBlockAutofill": true,
"browserBlockAutomaticDetectionOfIntranetSites": true,
"browserBlockEnterpriseModeAccess": true,
"browserBlockJavaScript": true,
"browserBlockPlugins": true,
"browserBlockPopups": true,
"browserBlockSendingDoNotTrackHeader": true,
"browserBlockSingleWordEntryOnIntranetSites": true,
"browserRequireSmartScreen": true,
"browserEnterpriseModeSiteListLocation": "Browser Enterprise Mode Site List Location value",
"browserInternetSecurityLevel": "medium",
"browserIntranetSecurityLevel": "low",
"browserLoggingReportLocation": "Browser Logging Report Location value",
"browserRequireHighSecurityForRestrictedSites": true,
"browserRequireFirewall": true,
"browserRequireFraudWarning": true,
"browserTrustedSitesSecurityLevel": "low",
"cellularBlockDataRoaming": true,
"diagnosticsBlockDataSubmission": true,
"passwordBlockPicturePasswordAndPin": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordMinimumCharacterSetCount": 0,
"passwordPreviousPasswordBlockCount": 2,
"passwordRequiredType": "alphanumeric",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"storageRequireDeviceEncryption": true,
"updatesRequireAutomaticUpdates": true,
"userAccountControlSettings": "alwaysNotify",
"workFoldersUrl": "https://example.com/workFoldersUrl/"
}