Erstellen von windowsKioskConfiguration
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 windowsKioskConfiguration-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Globaler Dienst | 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 die Authentifizierung und Autorisierung. |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das windowsKioskConfiguration-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von windowsKioskConfiguration 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-Sammlung | 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. |
| kioskProfiles | windowsKioskProfile-Sammlung | Diese Richtlinieneinstellung ermöglicht das Definieren einer Liste von Kioskprofilen für eine Kioskkonfiguration. Diese Auflistung kann maximal 3 Elemente enthalten. |
| kioskBrowserDefaultUrl | String | Geben Sie die Standard-URL an, zu der der Browser beim Start navigieren soll. |
| kioskBrowserEnableHomeButton | Boolesch | Aktivieren Sie die Startschaltfläche des Kioskbrowsers. Standardmäßig ist die Startschaltfläche deaktiviert. |
| kioskBrowserEnableNavigationButtons | Boolesch | Aktivieren Sie die Navigationsschaltflächen des Kioskbrowsers (vorwärts/zurück). Standardmäßig sind die Navigationsschaltflächen deaktiviert. |
| kioskBrowserEnableEndSessionButton | Boolesch | Aktivieren Sie die Schaltfläche zum Beenden der Sitzung des Kioskbrowsers. Standardmäßig ist die Schaltfläche "Sitzung beenden" deaktiviert. |
| kioskBrowserRestartOnIdleTimeInMinutes | Int32 | Geben Sie die Anzahl der Minuten an, in der sich die Sitzung im Leerlauf befindet, bis der Kioskbrowser in einem neuen Zustand neu gestartet wird. Gültige Werte sind 1 bis 1440. Gültige Werte 1 bis 1440 |
| kioskBrowserBlockedURLs | String collection | Geben Sie URLs an, zu denen die Kioskbrowser nicht navigieren sollen. |
| kioskBrowserBlockedUrlExceptions | String collection | Angeben von URLs, zu denen der Kioskbrowser navigieren darf |
| edgeKioskEnablePublicBrowsing | Boolesch | Aktivieren Sie den Kioskmodus für öffentliches Browsen für den Microsoft Edge-Browser. Der Standardwert ist false. |
| windowsKioskForceUpdateSchedule | windowsKioskForceUpdateSchedule | Erzwingen des Updatezeitplans für Kioskgeräte. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein windowsKioskConfiguration-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: 2829
{
"@odata.type": "#microsoft.graph.windowsKioskConfiguration",
"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,
"kioskProfiles": [
{
"@odata.type": "microsoft.graph.windowsKioskProfile",
"profileId": "Profile Id value",
"profileName": "Profile Name value",
"appConfiguration": {
"@odata.type": "microsoft.graph.windowsKioskMultipleApps",
"apps": [
{
"@odata.type": "microsoft.graph.windowsKioskUWPApp",
"startLayoutTileSize": "small",
"name": "Name value",
"appType": "store",
"autoLaunch": true,
"appUserModelId": "App User Model Id value",
"appId": "App Id value",
"containedAppId": "Contained App Id value"
}
],
"showTaskBar": true,
"allowAccessToDownloadsFolder": true,
"disallowDesktopApps": true,
"startMenuLayoutXml": "c3RhcnRNZW51TGF5b3V0WG1s"
},
"userAccountsConfiguration": [
{
"@odata.type": "microsoft.graph.windowsKioskVisitor"
}
]
}
],
"kioskBrowserDefaultUrl": "https://example.com/kioskBrowserDefaultUrl/",
"kioskBrowserEnableHomeButton": true,
"kioskBrowserEnableNavigationButtons": true,
"kioskBrowserEnableEndSessionButton": true,
"kioskBrowserRestartOnIdleTimeInMinutes": 6,
"kioskBrowserBlockedURLs": [
"Kiosk Browser Blocked URLs value"
],
"kioskBrowserBlockedUrlExceptions": [
"Kiosk Browser Blocked Url Exceptions value"
],
"edgeKioskEnablePublicBrowsing": true,
"windowsKioskForceUpdateSchedule": {
"@odata.type": "microsoft.graph.windowsKioskForceUpdateSchedule",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"recurrence": "daily",
"dayofWeek": "monday",
"dayofMonth": 10,
"runImmediatelyIfAfterStartDateTime": true
}
}
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: 3001
{
"@odata.type": "#microsoft.graph.windowsKioskConfiguration",
"id": "146a990b-990b-146a-0b99-6a140b996a14",
"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,
"kioskProfiles": [
{
"@odata.type": "microsoft.graph.windowsKioskProfile",
"profileId": "Profile Id value",
"profileName": "Profile Name value",
"appConfiguration": {
"@odata.type": "microsoft.graph.windowsKioskMultipleApps",
"apps": [
{
"@odata.type": "microsoft.graph.windowsKioskUWPApp",
"startLayoutTileSize": "small",
"name": "Name value",
"appType": "store",
"autoLaunch": true,
"appUserModelId": "App User Model Id value",
"appId": "App Id value",
"containedAppId": "Contained App Id value"
}
],
"showTaskBar": true,
"allowAccessToDownloadsFolder": true,
"disallowDesktopApps": true,
"startMenuLayoutXml": "c3RhcnRNZW51TGF5b3V0WG1s"
},
"userAccountsConfiguration": [
{
"@odata.type": "microsoft.graph.windowsKioskVisitor"
}
]
}
],
"kioskBrowserDefaultUrl": "https://example.com/kioskBrowserDefaultUrl/",
"kioskBrowserEnableHomeButton": true,
"kioskBrowserEnableNavigationButtons": true,
"kioskBrowserEnableEndSessionButton": true,
"kioskBrowserRestartOnIdleTimeInMinutes": 6,
"kioskBrowserBlockedURLs": [
"Kiosk Browser Blocked URLs value"
],
"kioskBrowserBlockedUrlExceptions": [
"Kiosk Browser Blocked Url Exceptions value"
],
"edgeKioskEnablePublicBrowsing": true,
"windowsKioskForceUpdateSchedule": {
"@odata.type": "microsoft.graph.windowsKioskForceUpdateSchedule",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"recurrence": "daily",
"dayofWeek": "monday",
"dayofMonth": 10,
"runImmediatelyIfAfterStartDateTime": true
}
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für