From 338987a825264e7ae9f49ffde47fb9d229ff76f2 Mon Sep 17 00:00:00 2001 From: Paolo Matarazzo <74918781+paolomatarazzo@users.noreply.github.com> Date: Thu, 15 Feb 2024 23:07:59 +0100 Subject: [PATCH] Update kiosk configuration with Shell Launcher --- .../kiosk/assigned-access-quickstart-kiosk.md | 2 +- .../shell-launcher-quickstart-intune.md | 14 ++++++ .../includes/shell-launcher-quickstart-ps.md | 46 ++++++++++++++++++ .../includes/shell-launcher-quickstart-xml.md | 36 ++++++++++++++ .../kiosk/shell-launcher-quickstart-kiosk.md | 48 ++----------------- 5 files changed, 100 insertions(+), 46 deletions(-) create mode 100644 windows/configuration/kiosk/includes/shell-launcher-quickstart-intune.md create mode 100644 windows/configuration/kiosk/includes/shell-launcher-quickstart-ps.md create mode 100644 windows/configuration/kiosk/includes/shell-launcher-quickstart-xml.md diff --git a/windows/configuration/kiosk/assigned-access-quickstart-kiosk.md b/windows/configuration/kiosk/assigned-access-quickstart-kiosk.md index 7b766d58c4..4ae2bf79d1 100644 --- a/windows/configuration/kiosk/assigned-access-quickstart-kiosk.md +++ b/windows/configuration/kiosk/assigned-access-quickstart-kiosk.md @@ -70,7 +70,7 @@ Alternatively, you can configure devices using a [custom policy][MEM-1] with the ## User experience -After the settings are applied, reboot the device. A user account named `Airport Kiosk` is automatically signed in, opening Microsoft Edge with an airport map. +After the settings are applied, reboot the device. A local user account named `Airport Kiosk` is automatically signed in, opening Microsoft Edge with an airport map. ## Next steps diff --git a/windows/configuration/kiosk/includes/shell-launcher-quickstart-intune.md b/windows/configuration/kiosk/includes/shell-launcher-quickstart-intune.md new file mode 100644 index 0000000000..cc124eeed7 --- /dev/null +++ b/windows/configuration/kiosk/includes/shell-launcher-quickstart-intune.md @@ -0,0 +1,14 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 02/05/2024 +ms.topic: include +ms.prod: windows-client +--- + +```msgraph-interactive +POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations +Content-Type: application/json + +{ "id": "00-0000-0000-0000-000000000000", "displayName": "_MSLearn_Example_Kiosk - Shell Launcher", "description": "This is a sample policy created from an article on learn.microsoft.com.", "roleScopeTagIds": [ "0" ], "@odata.type": "#microsoft.graph.windows10CustomConfiguration", "omaSettings": [ { "@odata.type": "#microsoft.graph.omaSettingString", "displayName": "ShellLauncher", "description": null, "omaUri": "./Vendor/MSFT/AssignedAccess/ShellLauncher", "secretReferenceValueId": null, "isEncrypted": true, "value": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n" } ], } +``` \ No newline at end of file diff --git a/windows/configuration/kiosk/includes/shell-launcher-quickstart-ps.md b/windows/configuration/kiosk/includes/shell-launcher-quickstart-ps.md new file mode 100644 index 0000000000..f1989bbd98 --- /dev/null +++ b/windows/configuration/kiosk/includes/shell-launcher-quickstart-ps.md @@ -0,0 +1,46 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 02/05/2024 +ms.topic: include +ms.prod: windows-client +--- + +```PowerShell +$shellLauncherConfiguration = @" + + + + + + + + + + + + + + + + + + + + + + + + +"@ + +$namespaceName="root\cimv2\mdm\dmmap" +$className="MDM_AssignedAccess" +$obj = Get-CimInstance -Namespace $namespaceName -ClassName $className +$obj.ShellLauncher = [System.Net.WebUtility]::HtmlEncode($shellLauncherConfiguration) +$obj = Set-CimInstance -CimInstance $obj + + +``` \ No newline at end of file diff --git a/windows/configuration/kiosk/includes/shell-launcher-quickstart-xml.md b/windows/configuration/kiosk/includes/shell-launcher-quickstart-xml.md new file mode 100644 index 0000000000..7e483e140f --- /dev/null +++ b/windows/configuration/kiosk/includes/shell-launcher-quickstart-xml.md @@ -0,0 +1,36 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 02/05/2024 +ms.topic: include +ms.prod: windows-client +--- + +```xml + + + + + + + + + + + + + + + + + + + + + + + + +``` \ No newline at end of file diff --git a/windows/configuration/kiosk/shell-launcher-quickstart-kiosk.md b/windows/configuration/kiosk/shell-launcher-quickstart-kiosk.md index ce92d39f96..4d6192e6bd 100644 --- a/windows/configuration/kiosk/shell-launcher-quickstart-kiosk.md +++ b/windows/configuration/kiosk/shell-launcher-quickstart-kiosk.md @@ -31,12 +31,7 @@ This quickstart provides the information to configure a kiosk experience with Sh > > When using this call, authenticate to your tenant in the Graph Explorer window. If it's the first time using Graph Explorer, you may need to authorize the application to access your tenant or to modify the existing permissions. This graph call requires *DeviceManagementConfiguration.ReadWrite.All* permissions. -```msgraph-interactive -POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations -Content-Type: application/json - -{ "id": "00-0000-0000-0000-000000000000", "displayName": "_MSLearn_Example_Kiosk - Shell Launcher", "description": "This is a sample policy created from an article on learn.microsoft.com.", "roleScopeTagIds": [ "0" ], "@odata.type": "#microsoft.graph.windows10CustomConfiguration", "omaSettings": [ { "@odata.type": "#microsoft.graph.omaSettingString", "displayName": "ShellLauncher", "description": null, "omaUri": "./Vendor/MSFT/AssignedAccess/ShellLauncher", "secretReferenceValueId": null, "isEncrypted": true, "value": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n" } ], } -``` +[!INCLUDE [shell-launcher-quickstart-intune](includes/shell-launcher-quickstart-intune.md)] [!INCLUDE [intune-custom-settings-2](../../../includes/configure/intune-custom-settings-2.md)] @@ -51,44 +46,7 @@ Alternatively, you can configure devices using a [custom policy][MEM-1] with the [!INCLUDE [powershell-wmi-bridge-1](../../../includes/configure/powershell-wmi-bridge-1.md)] -```PowerShell -$shellLauncherConfiguration = @" - - - - - - - - - - - - - - - - - - - - - - - - -"@ - -$namespaceName="root\cimv2\mdm\dmmap" -$className="MDM_AssignedAccess" -$obj = Get-CimInstance -Namespace $namespaceName -ClassName $className -$obj.ShellLauncher = [System.Net.WebUtility]::HtmlEncode($shellLauncherConfiguration) -$obj = Set-CimInstance -CimInstance $obj - - -``` +[!INCLUDE [shell-launcher-quickstart-ps](includes/shell-launcher-quickstart-ps.md)] [!INCLUDE [powershell-wmi-bridge-2](../../../includes/configure/powershell-wmi-bridge-2.md)] @@ -96,7 +54,7 @@ $obj = Set-CimInstance -CimInstance $obj ## User experience -After the settings are applied, reboot the device. A local account is automatically signed in, and Microsoft Edge app starts automatically in full screen, opening the London Heathrow airport map. +After the settings are applied, reboot the device. A local user account named `Airport Kiosk` is automatically signed in, opening Microsoft Edge with an airport map. ## Next steps