Freigeben über


Erstellen von „windows81GeneralConfiguration“

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
Anwendung 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 und high.
browserIntranetSecurityLevel siteSecurityLevel Intranetsicherheitsstufe. Mögliche Werte sind: userDefined, low, mediumLow, medium, mediumHigh und 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 und 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. Mögliche Werte sind: deviceDefault, alphanumeric und 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: 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/"
}