From 2ed2b3471a1c8b2551bf8942225e3d49597b2d50 Mon Sep 17 00:00:00 2001 From: Paolo Matarazzo <74918781+paolomatarazzo@users.noreply.github.com> Date: Mon, 26 Feb 2024 09:09:26 -0500 Subject: [PATCH] Update kiosk configuration and shell launcher XML file --- .../configuration/assigned-access/index.md | 10 +-- .../shell-launcher-configuration-file.md | 76 +++++++++++++++---- 2 files changed, 67 insertions(+), 19 deletions(-) diff --git a/windows/configuration/assigned-access/index.md b/windows/configuration/assigned-access/index.md index 2c8c944956..4cb63e83bd 100644 --- a/windows/configuration/assigned-access/index.md +++ b/windows/configuration/assigned-access/index.md @@ -1,11 +1,11 @@ --- -title: Configure kiosks and digital signs on Windows 10/11 desktop editions -description: In this article, learn about the methods for configuring kiosks and digital signs on Windows 10 or Windows 11 desktop editions. -ms.topic: article -ms.date: 12/31/2017 +title: Configure kiosks and restricted user experiences +description: Learn about the options available in Windows to configure kiosks and restricted user experiences. +ms.topic: overview +ms.date: 02/26/2024 --- -# Configure kiosks and digital signs on Windows desktop editions +# Configure kiosks and restricted user experiences Organization may want to set up special purpose devices, such as a device in the lobby that customers can use to view product catalogs, or a device displaying visual content as a digital sign. Windows client offers two different locked-down experiences for public or specialized use: diff --git a/windows/configuration/assigned-access/shell-launcher-configuration-file.md b/windows/configuration/assigned-access/shell-launcher-configuration-file.md index b366633ad2..fd26800d2d 100644 --- a/windows/configuration/assigned-access/shell-launcher-configuration-file.md +++ b/windows/configuration/assigned-access/shell-launcher-configuration-file.md @@ -11,12 +11,71 @@ This article provides practical examples of Shell Launcher XML configuration fil Let's start by looking at the basic structure of the XML file. -- A configuration xml can define multiple `profiles`. Each profile has a *profile Id* and defines a set of applications that are allowed to run -- A configuration xml can have multiple `configs`. Each config associates a non-admin user account to a default profile Id -- A profile has no effect if it's not associated to a user account +- A configuration xml can define one or multiple `Profiles` + - Each profile has a unique `Profile Id` and defines a `Shell` elemnt, which is the application that executes when the user signs in + - A profile can define a default action to be taken when the application exits and may define actions to be taken when the application exits with a specific return code + - A profile must be associated to a user account to have an effect + - You can define a `Default profile` that is used when no other profile is associated to a user account +- A configuration xml can define one or multiple `configs` + - Each config associates a user account to a `profile Id` + - A profile has no effect if it's not associated to a user account You can start your file by pasting the following XML code into a text editor, and saving the file with an xml extension. For example, `kiosk.xml`. +```xml + + + + ... + + + ... + + +``` + +## Profiles node + +If you want to define a default profile, you can use the `DefaultProfile` element: + +```xml + + + ... + + +``` + +Each profile is identified by a unique identifier `Profile Id`, for example: + +```xml + + + ... + + +``` + +### Shell node + +The `Shell` node defines the application that executes when the user signs in: + +- The `Shell` attribute is the path to the application +- The `V2:AppType` attribute defines the type of application +- The `V2:AllAppsFullScreen` attribute is a boolean value that defines if all applications are executed in full screen + +```xml + + + + + + +``` + + ```xml ``` -## Profiles node - -An Shell Launcher configuration file can contain one or more profiles. Each profile is identified by a unique identified `Profile Id`, for example: - -```xml - - - ... - - -``` ### AppType