From 34eefe4acdac776cd2871edc8381d0be18f3532b Mon Sep 17 00:00:00 2001 From: Paolo Matarazzo <74918781+paolomatarazzo@users.noreply.github.com> Date: Thu, 25 Jan 2024 07:40:16 -0500 Subject: [PATCH] Update file paths in kiosk-methods.md and assigned-access-kiosk-mode.md --- windows/configuration/cortana-at-work/toc.yml | 47 ++ windows/configuration/kiosk/kiosk-methods.md | 2 +- windows/configuration/kiosk/toc.yml | 37 ++ .../lock-screen/windows-spotlight.md | 29 +- .../provisioning-packages/toc.yml | 29 ++ windows/configuration/shared-pc/toc.yml | 7 + windows/configuration/start/toc.yml | 25 + .../taskbar/configure-windows-10-taskbar.md | 35 +- .../taskbar/customize-taskbar-windows-11.md | 36 +- windows/configuration/taskbar/toc.yml | 7 + .../manage-tips-and-suggestions.md | 51 +-- windows/configuration/toc.yml | 427 +----------------- windows/configuration/ue-v/toc.yml | 65 +++ ...ing-uev-with-windows-powershell-and-wmi.md | 16 +- .../ue-v/uev-administering-uev.md | 15 - ...v-application-template-schema-reference.md | 76 +--- ...anging-the-frequency-of-scheduled-tasks.md | 32 +- ...nfiguring-uev-with-group-policy-objects.md | 37 +- ...ith-system-center-configuration-manager.md | 198 ++++---- .../ue-v/uev-deploy-required-features.md | 82 ++-- .../uev-deploy-uev-for-custom-applications.md | 139 ++---- windows/configuration/ue-v/uev-for-windows.md | 43 +- .../configuration/ue-v/uev-getting-started.md | 123 ++--- ...anage-administrative-backup-and-restore.md | 36 +- .../ue-v/uev-manage-configurations.md | 19 +- ...plates-using-windows-powershell-and-wmi.md | 34 +- ...ackages-with-windows-powershell-and-wmi.md | 25 +- .../ue-v/uev-migrating-settings-packages.md | 25 +- .../ue-v/uev-prepare-for-deployment.md | 120 ++--- .../ue-v/uev-release-notes-1607.md | 10 +- .../ue-v/uev-security-considerations.md | 29 +- .../ue-v/uev-sync-trigger-events.md | 13 - ...synchronizing-microsoft-office-with-uev.md | 7 +- .../ue-v/uev-technical-reference.md | 30 -- .../configuration/ue-v/uev-troubleshooting.md | 14 - .../uev-upgrade-uev-from-previous-releases.md | 79 ++-- ...application-virtualization-applications.md | 11 +- .../ue-v/uev-whats-new-in-uev-for-windows.md | 21 +- ...-custom-templates-and-the-uev-generator.md | 77 +--- windows/configuration/wcd/toc.yml | 111 +++++ 40 files changed, 786 insertions(+), 1433 deletions(-) create mode 100644 windows/configuration/cortana-at-work/toc.yml create mode 100644 windows/configuration/kiosk/toc.yml create mode 100644 windows/configuration/provisioning-packages/toc.yml create mode 100644 windows/configuration/shared-pc/toc.yml create mode 100644 windows/configuration/start/toc.yml create mode 100644 windows/configuration/taskbar/toc.yml rename windows/configuration/{spotlight => tips}/manage-tips-and-suggestions.md (67%) create mode 100644 windows/configuration/ue-v/toc.yml create mode 100644 windows/configuration/wcd/toc.yml diff --git a/windows/configuration/cortana-at-work/toc.yml b/windows/configuration/cortana-at-work/toc.yml new file mode 100644 index 0000000000..5bfb4d8da1 --- /dev/null +++ b/windows/configuration/cortana-at-work/toc.yml @@ -0,0 +1,47 @@ +items: +- name: Configure Cortana in Windows 10 + href: cortana-at-work-overview.md +- name: Testing scenarios using Cortana n Windows 10, version 2004 and later + items: + - name: Set up and test Cortana in Windows 10, version 2004 and later + href: set-up-and-test-cortana-in-windows-10.md + - name: Cortana at work testing scenarios + href: cortana-at-work-testing-scenarios.md + - name: Test scenario 1 - Sign into Microsoft Entra ID, enable the wake word, and try a voice query + href: cortana-at-work-scenario-1.md + - name: Test scenario 2 - Run a Bing search with Cortana + href: cortana-at-work-scenario-2.md + - name: Test scenario 3 - Set a reminder + href: cortana-at-work-scenario-3.md + - name: Test scenario 4 - Use Cortana to find free time on your calendar + href: cortana-at-work-scenario-4.md + - name: Test scenario 5 - Find out about a person + href: cortana-at-work-scenario-5.md + - name: Test scenario 6 - Change your language and run a quick search with Cortana + href: cortana-at-work-scenario-6.md +- name: Send feedback about Cortana back to Microsoft + href: cortana-at-work-feedback.md +- name: Testing scenarios using Cortana in Windows 10, versions 1909 and earlier, with Microsoft 365 in your organization + items: + - name: Set up and test Cortana in Windows 10, versions 1909 and earlier, with Microsoft 365 in your organization + href: cortana-at-work-o365.md + - name: Testing scenarios using Cortana in your business or organization + href: testing-scenarios-using-cortana-in-business-org.md + - name: Test scenario 1 - Sign into Microsoft Entra ID, enable the wake word, and try a voice query + href: test-scenario-1.md + - name: Test scenario 2 - Run a quick search with Cortana at work + href: test-scenario-2.md + - name: Test scenario 3 - Set a reminder for a specific location using Cortana at work + href: test-scenario-3.md + - name: Test scenario 4 - Use Cortana at work to find your upcoming meetings + href: test-scenario-4.md + - name: Test scenario 5 - Use Cortana to send email to a coworker + href: test-scenario-5.md + - name: Test scenario 6 - Review a reminder suggested by Cortana based on what you’ve promised in email + href: test-scenario-6.md + - name: Test scenario 7 - Use Cortana and Windows Information Protection (WIP) to help protect your organization’s data on a device + href: cortana-at-work-scenario-7.md +- name: Set up and test custom voice commands in Cortana for your organization + href: cortana-at-work-voice-commands.md +- name: Use Group Policy and mobile device management (MDM) settings to configure Cortana in your organization + href: cortana-at-work-policy-settings.md \ No newline at end of file diff --git a/windows/configuration/kiosk/kiosk-methods.md b/windows/configuration/kiosk/kiosk-methods.md index 9fa5a42cfd..bb5d1002ca 100644 --- a/windows/configuration/kiosk/kiosk-methods.md +++ b/windows/configuration/kiosk/kiosk-methods.md @@ -65,7 +65,7 @@ There are several kiosk configuration methods that you can choose from, dependin >[!IMPORTANT] >Single-app kiosk mode isn't supported over a remote desktop connection. Your kiosk users must sign in on the physical device that is set up as a kiosk. -[!INCLUDE [assigned-access-kiosk-mode](../../includes/licensing/assigned-access-kiosk-mode.md)] +[!INCLUDE [assigned-access-kiosk-mode](../../../includes/licensing/assigned-access-kiosk-mode.md)] ## Methods for a single-app kiosk running a UWP app diff --git a/windows/configuration/kiosk/toc.yml b/windows/configuration/kiosk/toc.yml new file mode 100644 index 0000000000..154db9e4b7 --- /dev/null +++ b/windows/configuration/kiosk/toc.yml @@ -0,0 +1,37 @@ +items: +- name: Configure kiosks and digital signs on Windows desktop editions + href: kiosk-methods.md +- name: Prepare a device for kiosk configuration + href: kiosk-prepare.md +- name: Set up digital signs + href: setup-digital-signage.md +- name: Set up a single-app kiosk + href: kiosk-single-app.md +- name: Set up a multi-app kiosk for Windows 10 + href: lock-down-windows-10-to-specific-apps.md +- name: Set up a multi-app kiosk for Windows 11 + href: lock-down-windows-11-to-specific-apps.md +- name: Kiosk reference information + items: + - name: More kiosk methods and reference information + href: kiosk-additional-reference.md + - name: Find the Application User Model ID of an installed app + href: find-the-application-user-model-id-of-an-installed-app.md + - name: Validate your kiosk configuration + href: kiosk-validate.md + - name: Guidelines for choosing an app for assigned access (kiosk mode) + href: guidelines-for-assigned-access-app.md + - name: Policies enforced on kiosk devices + href: kiosk-policies.md + - name: Assigned access XML reference + href: kiosk-xml.md + - name: Use AppLocker to create a Windows 10 kiosk + href: lock-down-windows-10-applocker.md + - name: Use Shell Launcher to create a Windows client kiosk + href: kiosk-shelllauncher.md + - name: Use MDM Bridge WMI Provider to create a Windows client kiosk + href: kiosk-mdm-bridge.md + - name: Troubleshoot kiosk mode issues + href: /troubleshoot/windows-client/shell-experience/kiosk-mode-issues-troubleshooting +- name: Lockdown features from Windows Embedded 8.1 Industry + href: lockdown-features-windows-10.md \ No newline at end of file diff --git a/windows/configuration/lock-screen/windows-spotlight.md b/windows/configuration/lock-screen/windows-spotlight.md index 2578087d2b..5057522fad 100644 --- a/windows/configuration/lock-screen/windows-spotlight.md +++ b/windows/configuration/lock-screen/windows-spotlight.md @@ -5,37 +5,29 @@ ms.topic: article ms.date: 04/30/2018 --- -# Configure Windows Spotlight on the lock screen - - -**Applies to** - -- Windows 10 - +# Configure Windows Spotlight on the lock screen Windows Spotlight is an option for the lock screen background that displays different background images and occasionally offers suggestions on the lock screen. Windows Spotlight is available in all desktop editions of Windows 10. For managed devices running Windows 10 Enterprise and Windows 10 Education, enterprise administrators can configure a mobile device management (MDM) or Group Policy setting to prevent users from using the Windows Spotlight background. For managed devices running Windows 10 Pro, version 1607, administrators can disable suggestions for third party apps. - >[!NOTE] >In Windows 10, version 1607, the lock screen background does not display if you disable the **Animate windows when minimizing and maximizing** setting in **This PC** > **Properties** > **Advanced system settings** > **Performance settings** > **Visual Effects**, or if you enable the Group Policy setting **Computer Configuration** > **Administrative Templates** > **Windows Components** > **Desktop Windows Manager** > **Do not allow windows animations**. > >In Windows 10, version 1703, you can use the [Personalization CSP](/windows/client-management/mdm/personalization-csp) settings to set lock screen and desktop background images. -## What does Windows Spotlight include? +## What does Windows Spotlight include? - -- **Background image** +- **Background image** The Windows Spotlight displays a new image on the lock screen each day. The initial background image is included during installation. More images are downloaded on ongoing basis. - ![lock screen image.](images/lockscreen.png) + ![lock screen image.](images/lockscreen.png) -- **Feature suggestions, fun facts, tips** +- **Feature suggestions, fun facts, tips** The lock screen background will occasionally make recommendations on how to enhance your productivity and enjoyment of Microsoft products including suggesting other relevant Microsoft products and services. - + ![fun facts.](images/funfacts.png) @@ -86,12 +78,3 @@ A custom lock screen image created in 16:9 aspect ratio (1600x900) will scale pr Lock screen images created at other aspect ratios may scale and center unpredictably on your device when changing aspect ratios. The recommendation for custom lock screen images that include text (such as a legal statement) is to create the lock screen image in 16:9 resolution with text contained in the 4:3 region, allowing the text to remain visible at any aspect ratio. - -## Related topics - - -[Manage Windows 10 Start layout options](windows-10-start-layout-options-and-policies.md) - - - - diff --git a/windows/configuration/provisioning-packages/toc.yml b/windows/configuration/provisioning-packages/toc.yml new file mode 100644 index 0000000000..818ccc679e --- /dev/null +++ b/windows/configuration/provisioning-packages/toc.yml @@ -0,0 +1,29 @@ +items: + - name: Provisioning packages for Windows client + href: provisioning-packages.md + - name: How provisioning works in Windows client + href: provisioning-how-it-works.md + - name: Introduction to configuration service providers (CSPs) + href: how-it-pros-can-use-configuration-service-providers.md + - name: Install Windows Configuration Designer + href: provisioning-install-icd.md + - name: Create a provisioning package + href: provisioning-create-package.md + - name: Apply a provisioning package + href: provisioning-apply-package.md + - name: Settings changed when you uninstall a provisioning package + href: provisioning-uninstall-package.md + - name: Provision PCs with common settings for initial deployment (desktop wizard) + href: provision-pcs-for-initial-deployment.md + - name: Provision PCs with apps + href: provision-pcs-with-apps.md + - name: Use a script to install a desktop app in provisioning packages + href: provisioning-script-to-install-app.md + - name: Create a provisioning package with multivariant settings + href: provisioning-multivariant.md + - name: PowerShell cmdlets for provisioning Windows client (reference) + href: provisioning-powershell.md + - name: Diagnose provisioning packages + href: diagnose-provisioning-packages.md + - name: Windows Configuration Designer command-line interface (reference) + href: provisioning-command-line.md \ No newline at end of file diff --git a/windows/configuration/shared-pc/toc.yml b/windows/configuration/shared-pc/toc.yml new file mode 100644 index 0000000000..87e0ba65f6 --- /dev/null +++ b/windows/configuration/shared-pc/toc.yml @@ -0,0 +1,7 @@ +items: +- name: Shared devices concepts + href: shared-devices-concepts.md +- name: Configure shared devices with Shared PC + href: set-up-shared-or-guest-pc.md +- name: Shared PC technical reference + href: shared-pc-technical.md \ No newline at end of file diff --git a/windows/configuration/start/toc.yml b/windows/configuration/start/toc.yml new file mode 100644 index 0000000000..ab39581265 --- /dev/null +++ b/windows/configuration/start/toc.yml @@ -0,0 +1,25 @@ +items: +- name: Customizethe Start menu in Windows 11 + href: customize-start-menu-layout-windows-11.md +- name: Supported Start menu CSPs + href: supported-csp-start-menu-layout-windows.md +- name: Start layout and taskbar + href: windows-10-start-layout-options-and-policies.md +- name: Use XML + items: + - name: Customize and export Start layout + href: customize-and-export-start-layout.md + - name: Add image for secondary Microsoft Edge tiles + href: start-secondary-tiles.md + - name: Start layout XML for Windows 10 desktop editions (reference) + href: start-layout-xml-desktop.md +- name: Use group policy + href: customize-windows-10-start-screens-by-using-group-policy.md +- name: Use provisioning packages + href: customize-windows-10-start-screens-by-using-provisioning-packages-and-icd.md +- name: Use mobile device management (MDM) + href: customize-windows-10-start-screens-by-using-mobile-device-management.md +- name: Troubleshoot Start menu errors + href: /troubleshoot/windows-client/shell-experience/troubleshoot-start-menu-errors +- name: Changes to Start policies in Windows 10 + href: changes-to-start-policies-in-windows-10.md diff --git a/windows/configuration/taskbar/configure-windows-10-taskbar.md b/windows/configuration/taskbar/configure-windows-10-taskbar.md index 2e73630856..02b01b0f64 100644 --- a/windows/configuration/taskbar/configure-windows-10-taskbar.md +++ b/windows/configuration/taskbar/configure-windows-10-taskbar.md @@ -7,9 +7,9 @@ appliesto: - ✅ Windows 10 --- -# Configure Windows 10 taskbar +# Configure Windows 10 taskbar -Starting in Windows 10, version 1607, administrators can pin more apps to the taskbar and remove default pinned apps from the taskbar by adding a `` section to a layout modification XML file. This method never removes user-pinned apps from the taskbar. +Starting in Windows 10, version 1607, administrators can pin more apps to the taskbar and remove default pinned apps from the taskbar by adding a `` section to a layout modification XML file. This method never removes user-pinned apps from the taskbar. > [!NOTE] > The only aspect of the taskbar that can currently be configured by the layout modification XML file is the layout. @@ -23,14 +23,13 @@ The order of apps in the XML file dictates the order of pinned apps on the taskb > [!NOTE] > In operating systems configured to use a right-to-left language, the taskbar order will be reversed. -The following example shows how apps will be pinned: Windows default apps to the left (blue circle), apps pinned by the user in the center (orange triangle), and apps that you pin using the XML file to the right (green square). +The following example shows how apps will be pinned: Windows default apps to the left (blue circle), apps pinned by the user in the center (orange triangle), and apps that you pin using the XML file to the right (green square). ![Windows left, user center, enterprise to the right.](images/taskbar-generic.png) +## Configure taskbar (general) -## Configure taskbar (general) - -**To configure the taskbar:** +**To configure the taskbar:** 1. Create the XML file. * If you're also [customizing the Start layout](customize-and-export-start-layout.md), use `Export-StartLayout` to create the XML, and then add the `` section from [the following sample](#sample-taskbar-configuration-added-to-start-layout-xml-file) to the file. @@ -38,9 +37,9 @@ The following example shows how apps will be pinned: Windows default apps to the 2. Edit and save the XML file. You can use [AUMID](./find-the-application-user-model-id-of-an-installed-app.md) or Desktop Application Link Path to identify the apps to pin to the taskbar. * Add `xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"` to the first line of the file, before the closing \>. * Use `` and [AUMID](./find-the-application-user-model-id-of-an-installed-app.md) to pin Universal Windows Platform apps. - * Use `` and Desktop Application Link Path to pin desktop applications. + * Use `` and Desktop Application Link Path to pin desktop applications. -3. Apply the layout modification XML file to devices using [Group Policy](customize-windows-10-start-screens-by-using-group-policy.md) or a [provisioning package created in Windows Imaging and Configuration Designer (Windows ICD)](customize-windows-10-start-screens-by-using-provisioning-packages-and-icd.md). +3. Apply the layout modification XML file to devices using [Group Policy](customize-windows-10-start-screens-by-using-group-policy.md) or a [provisioning package created in Windows Imaging and Configuration Designer (Windows ICD)](customize-windows-10-start-screens-by-using-provisioning-packages-and-icd.md). >[!IMPORTANT] >If you use a provisioning package or import-startlayout to configure the taskbar, your configuration will be reapplied each time the explorer.exe process restarts. If your configuration pins an app and the user then unpins that app, the user's change will be overwritten the next time the configuration is applied. To apply a taskbar configuration that allows users to make changes that will persist, apply your configuration by using Group Policy. @@ -313,22 +312,4 @@ The resulting taskbar for computers in any other country region: -``` - -## Related topics - -[Manage Windows 10 Start and taskbar layout](windows-10-start-layout-options-and-policies.md) - -[Customize and export Start layout](customize-and-export-start-layout.md) - -[Add image for secondary tiles](start-secondary-tiles.md) - -[Start layout XML for desktop editions of Windows 10 (reference)](start-layout-xml-desktop.md) - -[Customize Windows 10 Start and taskbar with Group Policy](customize-windows-10-start-screens-by-using-group-policy.md) - -[Customize Windows 10 Start and taskbar with provisioning packages](customize-windows-10-start-screens-by-using-provisioning-packages-and-icd.md) - -[Customize Windows 10 Start and taskbar with mobile device management (MDM)](customize-windows-10-start-screens-by-using-mobile-device-management.md) - -[Changes to Start policies in Windows 10](changes-to-start-policies-in-windows-10.md) +``` diff --git a/windows/configuration/taskbar/customize-taskbar-windows-11.md b/windows/configuration/taskbar/customize-taskbar-windows-11.md index 542a3b08bf..1ca99ee29a 100644 --- a/windows/configuration/taskbar/customize-taskbar-windows-11.md +++ b/windows/configuration/taskbar/customize-taskbar-windows-11.md @@ -9,39 +9,35 @@ appliesto: - ✅ Windows 11 --- -# Customize the Taskbar on Windows 11 +# Customize the Taskbar on Windows 11 -> **Looking for OEM information?** See [Customize the Taskbar](/windows-hardware/customize/desktop/customize-the-windows-11-taskbar) and [Customize the Start layout](/windows-hardware/customize/desktop/customize-the-windows-11-start-menu). +> **Looking for OEM information?** See [Customize the Taskbar](/windows-hardware/customize/desktop/customize-the-windows-11-taskbar) and [Customize the Start layout](/windows-hardware/customize/desktop/customize-the-windows-11-start-menu). -Your organization can deploy a customized taskbar to your Windows devices. Customizing the taskbar is common when your organization uses a common set of apps, or wants to bring attention to specific apps. You can also remove the default pinned apps. +Your organization can deploy a customized taskbar to your Windows devices. Customizing the taskbar is common when your organization uses a common set of apps, or wants to bring attention to specific apps. You can also remove the default pinned apps. -For example, you can override the default set of apps with your own a set of pinned apps, and in the order you choose. As an administrator, use this feature to pin apps, remove default pinned apps, order the apps, and more on the taskbar. +For example, you can override the default set of apps with your own a set of pinned apps, and in the order you choose. As an administrator, use this feature to pin apps, remove default pinned apps, order the apps, and more on the taskbar. -To add apps you want pinned to the taskbar, you use an XML file. You can use an existing XML file, or create a new file. If you have an XML file that's used on Windows 10 devices, you can also use it on Windows 11 devices. You may have to update the App IDs. +To add apps you want pinned to the taskbar, you use an XML file. You can use an existing XML file, or create a new file. If you have an XML file that's used on Windows 10 devices, you can also use it on Windows 11 devices. You may have to update the App IDs. -This article shows you how to create the XML file, add apps to the XML, and deploy the XML file. To learn how to customize the taskbar buttons, see [CSP policies to customize Windows 11 taskbar buttons](supported-csp-taskbar-windows.md#csp-policies-to-customize-windows-11-taskbar-buttons). +This article shows you how to create the XML file, add apps to the XML, and deploy the XML file. To learn how to customize the taskbar buttons, see [CSP policies to customize Windows 11 taskbar buttons](supported-csp-taskbar-windows.md#csp-policies-to-customize-windows-11-taskbar-buttons). -## Before you begin - -- There isn't a limit on the number of apps that you can pin. In the XML file, add apps using the [Application User Model ID (AUMID)](./find-the-application-user-model-id-of-an-installed-app.md) or Desktop Application Link Path (the local path to the app). +## Before you begin +- There isn't a limit on the number of apps that you can pin. In the XML file, add apps using the [Application User Model ID (AUMID)](./find-the-application-user-model-id-of-an-installed-app.md) or Desktop Application Link Path (the local path to the app). - There are some situations that an app pinned in your XML file won't be pinned in the taskbar. For example, if an app isn't approved or installed for a user, then the pinned icon won't show on the taskbar. - -- The order of apps in the XML file dictates the order of pinned apps on the taskbar, from left to right, and to the right of any existing apps pinned by the user. If the OS is configured to use a right-to-left language, then the taskbar order is reversed. - +- The order of apps in the XML file dictates the order of pinned apps on the taskbar, from left to right, and to the right of any existing apps pinned by the user. If the OS is configured to use a right-to-left language, then the taskbar order is reversed. - Some classic Windows applications are packaged differently than they were in previous versions of Windows, including Notepad and File Explorer. Be sure to enter the correct AppID. For more information, see [Application User Model ID (AUMID)](./find-the-application-user-model-id-of-an-installed-app.md) and [Get the AUMID and Desktop app link path](#get-the-aumid-and-desktop-app-link-path) (in this article). +- It's recommended to use a Mobile Device Management (MDM) provider. MDM providers help manage your devices, and help manage apps on your devices. You can use Microsoft Intune. Intune is a family of products that include Microsoft Intune, which is a cloud service, and Configuration Manager, which is on-premises. -- It's recommended to use a Mobile Device Management (MDM) provider. MDM providers help manage your devices, and help manage apps on your devices. You can use Microsoft Intune. Intune is a family of products that include Microsoft Intune, which is a cloud service, and Configuration Manager, which is on-premises. - - In this article, we mention these services. If you're not managing your devices using an MDM provider, the following resources may help you get started: + In this article, we mention these services. If you're not managing your devices using an MDM provider, the following resources may help you get started: - [Endpoint Management at Microsoft](/mem/endpoint-manager-overview) - [What is Microsoft Intune](/mem/intune/fundamentals/what-is-intune) and [Microsoft Intune planning guide](/mem/intune/fundamentals/intune-planning-guide) - - [What is Configuration Manager?](/mem/configmgr/core/understand/introduction) + - [What is Configuration Manager?](/mem/configmgr/core/understand/introduction) -## Create the XML file +## Create the XML file -1. In a text editor, such as Visual Studio Code, create a new XML file. To help you get started, you can copy and paste the following XML sample. The sample pins 2 apps to the taskbar - File Explorer and the Command Prompt: +1. In a text editor, such as Visual Studio Code, create a new XML file. To help you get started, you can copy and paste the following XML sample. The sample pins 2 apps to the taskbar - File Explorer and the Command Prompt: ```xml @@ -60,7 +56,7 @@ This article shows you how to create the XML file, add apps to the XML, and depl - ``` + ``` 2. In the `` node, add (or remove) the apps you want pinned. You can pin Universal Windows Platform (UWP) apps and desktop apps: @@ -71,7 +67,7 @@ This article shows you how to create the XML file, add apps to the XML, and depl For more information, see [Get the AUMID and Desktop app link path](#get-the-aumid-and-desktop-app-link-path) (in this article). -3. In the `` node, the apps you add are pinned after the default apps. If you want to remove the default apps, and only show the apps you add in the XML file, then add `PinListPlacement="Replace"`: +3. In the `` node, the apps you add are pinned after the default apps. If you want to remove the default apps, and only show the apps you add in the XML file, then add `PinListPlacement="Replace"`: - ``: Keeps the default pinned apps. After the default apps, the apps you add are pinned. - ``: Unpins the default apps. Only the apps you add are pinned. diff --git a/windows/configuration/taskbar/toc.yml b/windows/configuration/taskbar/toc.yml new file mode 100644 index 0000000000..cbe3e66b83 --- /dev/null +++ b/windows/configuration/taskbar/toc.yml @@ -0,0 +1,7 @@ +items: +- name: Customize the Taskbar in Windows 11 + href: customize-taskbar-windows-11.md +- name: Supported Taskbar CSPs + href: supported-csp-taskbar-windows.md +- name: Customize the Taskbar in Windows 10 + href: configure-windows-10-taskbar.md \ No newline at end of file diff --git a/windows/configuration/spotlight/manage-tips-and-suggestions.md b/windows/configuration/tips/manage-tips-and-suggestions.md similarity index 67% rename from windows/configuration/spotlight/manage-tips-and-suggestions.md rename to windows/configuration/tips/manage-tips-and-suggestions.md index 41b3189146..b56833fa5f 100644 --- a/windows/configuration/spotlight/manage-tips-and-suggestions.md +++ b/windows/configuration/tips/manage-tips-and-suggestions.md @@ -2,56 +2,31 @@ title: Manage Windows 10 and Microsoft Store tips, fun facts, and suggestions description: Windows 10 provides organizations with various options to manage user experiences to provide a consistent and predictable experience for employees. ms.topic: article - ms.date: 09/20/2017 - --- -# Manage Windows 10 and Microsoft Store tips, "fun facts", and suggestions - - -**Applies to** - -- Windows 10 - +# Manage Windows 10 and Microsoft Store tips, "fun facts", and suggestions Since its inception, Windows 10 has included a number of user experience features that provide useful tips, "fun facts", and suggestions as you use Windows, as well as app suggestions from the Microsoft Store. These features are designed to help people get the most out of their Windows 10 experience by, for example, sharing new features, providing more details on the features they use, or sharing content available in the Microsoft Store. Examples of such user experiences include: -* **Windows Spotlight on the lock screen**. Daily updated images on the lock screen that can include additional facts and tips in “hotspots” that are revealed on hover. - +* **Windows Spotlight on the lock screen**. Daily updated images on the lock screen that can include additional facts and tips in "hotspots" that are revealed on hover. * **Start menu app suggestions**. App suggestions in Start that recommend productivity tool or utilities from the Microsoft Store. - -* **Additional apps on Start**. Additional apps pre-installed on the Start screen which can enhance the user’s experience. - +* **Additional apps on Start**. Additional apps pre-installed on the Start screen which can enhance the user's experience. * **Windows tips**. Contextual tips that appear based on specific user actions to reveal related Windows features or help users complete a scenario. - * **Microsoft account notifications**. For users who have a connected Microsoft account, toast notifications about their account like parental control notifications or subscription expiration. >[!TIP] -> On all Windows desktop editions, users can directly enable and disable Windows 10 tips, "fun facts", and suggestions and Microsoft Store suggestions. For example, users are able to select personal photos for the lock screen as opposed to the images provided by Microsoft, or turn off tips, "fun facts", or suggestions as they use Windows. +> On all Windows desktop editions, users can directly enable and disable Windows 10 tips, "fun facts", and suggestions and Microsoft Store suggestions. For example, users are able to select personal photos for the lock screen as opposed to the images provided by Microsoft, or turn off tips, "fun facts", or suggestions as they use Windows. -Windows 10 provides organizations the ability to centrally manage the type of content provided by these features through Group Policy or mobile device management (MDM). The following table describes how administrators can manage suggestions and tips in Windows 10 commercial and education editions. +Windows 10 provides organizations the ability to centrally manage the type of content provided by these features through Group Policy or mobile device management (MDM). The following table describes how administrators can manage suggestions and tips in Windows 10 commercial and education editions. -## Options available to manage Windows 10 tips and "fun facts" and Microsoft Store suggestions +## Options available to manage Windows 10 tips and "fun facts" and Microsoft Store suggestions -| Windows 10 edition | Disable |Show Microsoft apps only | Show Microsoft and popular third-party apps | -| --- | --- | --- | --- | -| Windows 10 Pro | No | Yes | Yes (default) | -| Windows 10 Enterprise | Yes | Yes | Yes (default) | -| Windows 10 Pro Education | Yes (default) | Yes | No (setting cannot be changed) | -| Windows 10 Education | Yes (default) | Yes | No (setting cannot be changed) | - -[Learn more about policy settings for Windows Spotlight.](windows-spotlight.md) - -## Related topics - -- [Manage Windows 10 Start layout](windows-10-start-layout-options-and-policies.md) -- [Cortana integration in your business or enterprise](cortana-at-work/cortana-at-work-overview.md) -- [Windows spotlight on the lock screen](windows-spotlight.md) -- [Windows 10 editions for education customers](/education/windows/windows-editions-for-education-customers) - - - - - +| Windows 10 edition | Disable | Show Microsoft apps only | Show Microsoft and popular third-party apps | +|--|--|--|--| +| Windows 10 Pro | No | Yes | Yes (default) | +| Windows 10 Enterprise | Yes | Yes | Yes (default) | +| Windows 10 Pro Education | Yes (default) | Yes | No (setting cannot be changed) | +| Windows 10 Education | Yes (default) | Yes | No (setting cannot be changed) | +[Learn more about policy settings for Windows Spotlight.](../lock-screen/windows-spotlight.md) diff --git a/windows/configuration/toc.yml b/windows/configuration/toc.yml index a9b2a23294..b88633c8f1 100644 --- a/windows/configuration/toc.yml +++ b/windows/configuration/toc.yml @@ -1,412 +1,31 @@ +items: - name: Configure Windows client href: index.yml +- name: Accessibility information for IT Pros + href: accessibility/index.md - name: Customize the appearance items: - - name: Windows 11 - items: - - name: Start menu - items: - - name: Customize Start menu layout - href: customize-start-menu-layout-windows-11.md - - name: Supported Start menu CSPs - href: supported-csp-start-menu-layout-windows.md - - name: Taskbar - items: - - name: Customize Taskbar - href: customize-taskbar-windows-11.md - - name: Supported Taskbar CSPs - href: supported-csp-taskbar-windows.md - - name: Windows 10 Start and taskbar - items: - - name: Start layout and taskbar - href: windows-10-start-layout-options-and-policies.md - - name: Use XML - items: - - - name: Customize and export Start layout - href: customize-and-export-start-layout.md - - name: Customize the taskbar - href: configure-windows-10-taskbar.md - - name: Add image for secondary Microsoft Edge tiles - href: start-secondary-tiles.md - - name: Start layout XML for Windows 10 desktop editions (reference) - href: start-layout-xml-desktop.md - - name: Use group policy - href: customize-windows-10-start-screens-by-using-group-policy.md - - name: Use provisioning packages - href: customize-windows-10-start-screens-by-using-provisioning-packages-and-icd.md - - name: Use mobile device management (MDM) - href: customize-windows-10-start-screens-by-using-mobile-device-management.md - - name: Troubleshoot Start menu errors - href: /troubleshoot/windows-client/shell-experience/troubleshoot-start-menu-errors - - name: Changes to Start policies in Windows 10 - href: changes-to-start-policies-in-windows-10.md - - name: Accessibility settings - items: - - name: Accessibility information for IT Pros - href: windows-accessibility-for-ITPros.md - - name: Configure access to Microsoft Store - href: stop-employees-from-using-microsoft-store.md - - name: Configure Windows Spotlight on the lock screen - href: windows-spotlight.md - - name: Manage Windows 10 and Microsoft Store tips, "fun facts", and suggestions - href: manage-tips-and-suggestions.md - - name: Configure cellular settings for tablets and PCs - href: provisioning-apn.md - - name: Lockdown features from Windows Embedded 8.1 Industry - href: lockdown-features-windows-10.md - - + - name: Start + href: start/toc.yml + - name: Taskbar + href: taskbar/toc.yml + - name: Configure access to the Microsoft Store + href: store/stop-employees-from-using-microsoft-store.md + - name: Configure Windows Spotlight on the lock screen + href: lock-screen/windows-spotlight.md + - name: Manage Microsoft Store tips, "fun facts", and suggestions + href: tips/manage-tips-and-suggestions.md + - name: Configure cellular settings for tablets and PCs + href: cellular/provisioning-apn.md - name: Configure kiosks and digital signs - items: - - name: Configure kiosks and digital signs on Windows desktop editions - href: kiosk-methods.md - - name: Prepare a device for kiosk configuration - href: kiosk-prepare.md - - name: Set up digital signs - href: setup-digital-signage.md - - name: Set up a single-app kiosk - href: kiosk-single-app.md - - name: Set up a multi-app kiosk for Windows 10 - href: lock-down-windows-10-to-specific-apps.md - - name: Set up a multi-app kiosk for Windows 11 - href: lock-down-windows-11-to-specific-apps.md - - name: Kiosk reference information - items: - - name: More kiosk methods and reference information - href: kiosk-additional-reference.md - - name: Find the Application User Model ID of an installed app - href: find-the-application-user-model-id-of-an-installed-app.md - - name: Validate your kiosk configuration - href: kiosk-validate.md - - name: Guidelines for choosing an app for assigned access (kiosk mode) - href: guidelines-for-assigned-access-app.md - - name: Policies enforced on kiosk devices - href: kiosk-policies.md - - name: Assigned access XML reference - href: kiosk-xml.md - - name: Use AppLocker to create a Windows 10 kiosk - href: lock-down-windows-10-applocker.md - - name: Use Shell Launcher to create a Windows client kiosk - href: kiosk-shelllauncher.md - - name: Use MDM Bridge WMI Provider to create a Windows client kiosk - href: kiosk-mdm-bridge.md - - name: Troubleshoot kiosk mode issues - href: /troubleshoot/windows-client/shell-experience/kiosk-mode-issues-troubleshooting - + href: kiosk/toc.yml - name: Configure multi-user and guest devices - - items: - - name: Shared devices concepts - href: shared-devices-concepts.md - - name: Configure shared devices with Shared PC - href: set-up-shared-or-guest-pc.md - - name: Shared PC technical reference - href: shared-pc-technical.md - + href: shared-pc/toc.yml - name: Use provisioning packages - items: - - name: Provisioning packages for Windows client - href: provisioning-packages/provisioning-packages.md - - name: How provisioning works in Windows client - href: provisioning-packages/provisioning-how-it-works.md - - name: Introduction to configuration service providers (CSPs) - href: provisioning-packages/how-it-pros-can-use-configuration-service-providers.md - - name: Install Windows Configuration Designer - href: provisioning-packages/provisioning-install-icd.md - - name: Create a provisioning package - href: provisioning-packages/provisioning-create-package.md - - name: Apply a provisioning package - href: provisioning-packages/provisioning-apply-package.md - - name: Settings changed when you uninstall a provisioning package - href: provisioning-packages/provisioning-uninstall-package.md - - name: Provision PCs with common settings for initial deployment (desktop wizard) - href: provisioning-packages/provision-pcs-for-initial-deployment.md - - name: Provision PCs with apps - href: provisioning-packages/provision-pcs-with-apps.md - - name: Use a script to install a desktop app in provisioning packages - href: provisioning-packages/provisioning-script-to-install-app.md - - name: Create a provisioning package with multivariant settings - href: provisioning-packages/provisioning-multivariant.md - - name: PowerShell cmdlets for provisioning Windows client (reference) - href: provisioning-packages/provisioning-powershell.md - - name: Diagnose provisioning packages - href: provisioning-packages/diagnose-provisioning-packages.md - - name: Windows Configuration Designer command-line interface (reference) - href: provisioning-packages/provisioning-command-line.md - + href: provisioning-packages/toc.yml +- name: Windows Configuration Designer reference + href: wcd/toc.yml +- name: User Experience Virtualization (UE-V) + href: ue-v/toc.yml - name: Configure Cortana - items: - - name: Configure Cortana in Windows 10 - href: cortana-at-work/cortana-at-work-overview.md - - name: Testing scenarios using Cortana n Windows 10, version 2004 and later - items: - - name: Set up and test Cortana in Windows 10, version 2004 and later - href: cortana-at-work/set-up-and-test-cortana-in-windows-10.md - - name: Cortana at work testing scenarios - href: cortana-at-work/cortana-at-work-testing-scenarios.md - - name: Test scenario 1 - Sign into Microsoft Entra ID, enable the wake word, and try a voice query - href: cortana-at-work/cortana-at-work-scenario-1.md - - name: Test scenario 2 - Run a Bing search with Cortana - href: cortana-at-work/cortana-at-work-scenario-2.md - - name: Test scenario 3 - Set a reminder - href: cortana-at-work/cortana-at-work-scenario-3.md - - name: Test scenario 4 - Use Cortana to find free time on your calendar - href: cortana-at-work/cortana-at-work-scenario-4.md - - name: Test scenario 5 - Find out about a person - href: cortana-at-work/cortana-at-work-scenario-5.md - - name: Test scenario 6 - Change your language and run a quick search with Cortana - href: cortana-at-work/cortana-at-work-scenario-6.md - - name: Send feedback about Cortana back to Microsoft - href: cortana-at-work/cortana-at-work-feedback.md - - name: Testing scenarios using Cortana in Windows 10, versions 1909 and earlier, with Microsoft 365 in your organization - items: - - name: Set up and test Cortana in Windows 10, versions 1909 and earlier, with Microsoft 365 in your organization - href: cortana-at-work/cortana-at-work-o365.md - - name: Testing scenarios using Cortana in your business or organization - href: cortana-at-work/testing-scenarios-using-cortana-in-business-org.md - - name: Test scenario 1 - Sign into Microsoft Entra ID, enable the wake word, and try a voice query - href: cortana-at-work/test-scenario-1.md - - name: Test scenario 2 - Run a quick search with Cortana at work - href: cortana-at-work/test-scenario-2.md - - name: Test scenario 3 - Set a reminder for a specific location using Cortana at work - href: cortana-at-work/test-scenario-3.md - - name: Test scenario 4 - Use Cortana at work to find your upcoming meetings - href: cortana-at-work/test-scenario-4.md - - name: Test scenario 5 - Use Cortana to send email to a coworker - href: cortana-at-work/test-scenario-5.md - - name: Test scenario 6 - Review a reminder suggested by Cortana based on what you’ve promised in email - href: cortana-at-work/test-scenario-6.md - - name: Test scenario 7 - Use Cortana and Windows Information Protection (WIP) to help protect your organization’s data on a device - href: cortana-at-work/cortana-at-work-scenario-7.md - - - name: Set up and test custom voice commands in Cortana for your organization - href: cortana-at-work/cortana-at-work-voice-commands.md - - name: Use Group Policy and mobile device management (MDM) settings to configure Cortana in your organization - href: cortana-at-work/cortana-at-work-policy-settings.md - - -- name: Reference - items: - - name: Windows Configuration Designer reference - items: - - name: Windows Configuration Designer provisioning settings (reference) - href: wcd/wcd.md - - name: Changes to settings in Windows Configuration Designer - href: wcd/wcd-changes.md - - name: AccountManagement - href: wcd/wcd-accountmanagement.md - - name: Accounts - href: wcd/wcd-accounts.md - - - name: ADMXIngestion - href: wcd/wcd-admxingestion.md - - - name: AssignedAccess - href: wcd/wcd-assignedaccess.md - - - name: Browser - href: wcd/wcd-browser.md - - - name: CellCore - href: wcd/wcd-cellcore.md - - name: Cellular - href: wcd/wcd-cellular.md - - - name: Certificates - href: wcd/wcd-certificates.md - - - name: CleanPC - href: wcd/wcd-cleanpc.md - - - name: Connections - href: wcd/wcd-connections.md - - - name: ConnectivityProfiles - href: wcd/wcd-connectivityprofiles.md - - - name: CountryAndRegion - href: wcd/wcd-countryandregion.md - - - name: DesktopBackgroundAndColors - href: wcd/wcd-desktopbackgroundandcolors.md - - - name: DeveloperSetup - href: wcd/wcd-developersetup.md - - - name: DeviceFormFactor - href: wcd/wcd-deviceformfactor.md - - - name: DeviceManagement - href: wcd/wcd-devicemanagement.md - - - name: DeviceUpdateCenter - href: wcd/wcd-deviceupdatecenter.md - - name: DMClient - href: wcd/wcd-dmclient.md - - - name: EditionUpgrade - href: wcd/wcd-editionupgrade.md - - - name: FirewallConfiguration - href: wcd/wcd-firewallconfiguration.md - - - name: FirstExperience - href: wcd/wcd-firstexperience.md - - - name: Folders - href: wcd/wcd-folders.md - - - name: HotSpot - href: wcd/wcd-hotspot.md - - name: KioskBrowser - href: wcd/wcd-kioskbrowser.md - - - name: Licensing - href: wcd/wcd-licensing.md - - - name: Location - href: wcd/wcd-location.md - - - name: Maps - href: wcd/wcd-maps.md - - - name: NetworkProxy - href: wcd/wcd-networkproxy.md - - - name: NetworkQOSPolicy - href: wcd/wcd-networkqospolicy.md - - - name: OOBE - href: wcd/wcd-oobe.md - - - name: Personalization - href: wcd/wcd-personalization.md - - - name: Policies - href: wcd/wcd-policies.md - - - name: Privacy - href: wcd/wcd-privacy.md - - - name: ProvisioningCommands - href: wcd/wcd-provisioningcommands.md - - name: SharedPC - href: wcd/wcd-sharedpc.md - - - name: SMISettings - href: wcd/wcd-smisettings.md - - - name: Start - href: wcd/wcd-start.md - - - name: StartupApp - href: wcd/wcd-startupapp.md - - - name: StartupBackgroundTasks - href: wcd/wcd-startupbackgroundtasks.md - - - name: StorageD3InModernStandby - href: wcd/wcd-storaged3inmodernstandby.md - - name: SurfaceHubManagement - href: wcd/wcd-surfacehubmanagement.md - - - name: TabletMode - href: wcd/wcd-tabletmode.md - - - name: TakeATest - href: wcd/wcd-takeatest.md - - name: Time - href: wcd/wcd-time.md - - - name: UnifiedWriteFilter - href: wcd/wcd-unifiedwritefilter.md - - - name: UniversalAppInstall - href: wcd/wcd-universalappinstall.md - - - name: UniversalAppUninstall - href: wcd/wcd-universalappuninstall.md - - - name: UsbErrorsOEMOverride - href: wcd/wcd-usberrorsoemoverride.md - - name: WeakCharger - href: wcd/wcd-weakcharger.md - - - name: WindowsHelloForBusiness - href: wcd/wcd-windowshelloforbusiness.md - - name: WindowsTeamSettings - href: wcd/wcd-windowsteamsettings.md - - - name: WLAN - href: wcd/wcd-wlan.md - - - name: Workplace - href: wcd/wcd-workplace.md - - - name: User Experience Virtualization (UE-V) - items: - - name: User Experience Virtualization (UE-V) for Windows 10 - href: ue-v/uev-for-windows.md - - name: Get started with UE-V - items: - - name: Get started with UE-V - href: ue-v/uev-getting-started.md - - name: What's New in UE-V for Windows 10, version 1607 - href: ue-v/uev-whats-new-in-uev-for-windows.md - - name: User Experience Virtualization Release Notes - href: ue-v/uev-release-notes-1607.md - - name: Upgrade to UE-V for Windows 10 - href: ue-v/uev-upgrade-uev-from-previous-releases.md - - name: Prepare a UE-V Deployment - items: - - name: Prepare a UE-V Deployment - href: ue-v/uev-prepare-for-deployment.md - - name: Deploy Required UE-V Features - href: ue-v/uev-deploy-required-features.md - - name: Deploy UE-V for use with Custom Applications - href: ue-v/uev-deploy-uev-for-custom-applications.md - - name: Administer UE-V - items: - - name: UE-V administration guide - href: ue-v/uev-administering-uev.md - - name: Manage Configurations for UE-V - items: - - name: Manage Configurations for UE-V - href: ue-v/uev-manage-configurations.md - - name: Configuring UE-V with Group Policy Objects - href: ue-v/uev-configuring-uev-with-group-policy-objects.md - - name: Configuring UE-V with Microsoft Configuration Manager - href: ue-v/uev-configuring-uev-with-system-center-configuration-manager.md - - name: Administering UE-V with Windows PowerShell and WMI - href: ue-v/uev-administering-uev-with-windows-powershell-and-wmi.md - - name: Managing the UE-V Service and Packages with Windows PowerShell and WMI - href: ue-v/uev-managing-uev-agent-and-packages-with-windows-powershell-and-wmi.md - - name: Managing UE-V Settings Location Templates Using Windows PowerShell and WMI - href: ue-v/uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md - - name: Working with Custom UE-V Templates and the UE-V Template Generator - href: ue-v/uev-working-with-custom-templates-and-the-uev-generator.md - - name: Manage Administrative Backup and Restore in UE-V - href: ue-v/uev-manage-administrative-backup-and-restore.md - - name: Changing the Frequency of UE-V Scheduled Tasks - href: ue-v/uev-changing-the-frequency-of-scheduled-tasks.md - - name: Migrating UE-V Settings Packages - href: ue-v/uev-migrating-settings-packages.md - - name: Using UE-V with Application Virtualization Applications - href: ue-v/uev-using-uev-with-application-virtualization-applications.md - - name: Troubleshooting UE-V - href: ue-v/uev-troubleshooting.md - - name: Technical Reference for UE-V - items: - - name: Technical Reference for UE-V - href: ue-v/uev-technical-reference.md - - name: Sync Methods for UE-V - href: ue-v/uev-sync-methods.md - - name: Sync Trigger Events for UE-V - href: ue-v/uev-sync-trigger-events.md - - name: Synchronizing Microsoft Office with UE-V - href: ue-v/uev-synchronizing-microsoft-office-with-uev.md - - name: Application Template Schema Reference for UE-V - href: ue-v/uev-application-template-schema-reference.md - - name: Security Considerations for UE-V - href: ue-v/uev-security-considerations.md + href: cortana-at-work/toc.yml \ No newline at end of file diff --git a/windows/configuration/ue-v/toc.yml b/windows/configuration/ue-v/toc.yml new file mode 100644 index 0000000000..8da6a3d8d4 --- /dev/null +++ b/windows/configuration/ue-v/toc.yml @@ -0,0 +1,65 @@ +items: +- name: User Experience Virtualization (UE-V) for Windows 10 + href: uev-for-windows.md +- name: Get started with UE-V + items: + - name: Get started with UE-V + href: uev-getting-started.md + - name: What's New in UE-V for Windows 10, version 1607 + href: uev-whats-new-in-uev-for-windows.md + - name: User Experience Virtualization Release Notes + href: uev-release-notes-1607.md + - name: Upgrade to UE-V for Windows 10 + href: uev-upgrade-uev-from-previous-releases.md +- name: Prepare a UE-V Deployment + items: + - name: Prepare a UE-V Deployment + href: uev-prepare-for-deployment.md + - name: Deploy Required UE-V Features + href: uev-deploy-required-features.md + - name: Deploy UE-V for use with Custom Applications + href: uev-deploy-uev-for-custom-applications.md +- name: Administer UE-V + items: + - name: UE-V administration guide + href: uev-administering-uev.md + - name: Manage Configurations for UE-V + items: + - name: Manage Configurations for UE-V + href: uev-manage-configurations.md + - name: Configuring UE-V with Group Policy Objects + href: uev-configuring-uev-with-group-policy-objects.md + - name: Configuring UE-V with Microsoft Configuration Manager + href: uev-configuring-uev-with-system-center-configuration-manager.md + - name: Administering UE-V with Windows PowerShell and WMI + href: uev-administering-uev-with-windows-powershell-and-wmi.md + - name: Managing the UE-V Service and Packages with Windows PowerShell and WMI + href: uev-managing-uev-agent-and-packages-with-windows-powershell-and-wmi.md + - name: Managing UE-V Settings Location Templates Using Windows PowerShell and WMI + href: uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md + - name: Working with Custom UE-V Templates and the UE-V Template Generator + href: uev-working-with-custom-templates-and-the-uev-generator.md + - name: Manage Administrative Backup and Restore in UE-V + href: uev-manage-administrative-backup-and-restore.md + - name: Changing the Frequency of UE-V Scheduled Tasks + href: uev-changing-the-frequency-of-scheduled-tasks.md + - name: Migrating UE-V Settings Packages + href: uev-migrating-settings-packages.md + - name: Using UE-V with Application Virtualization Applications + href: uev-using-uev-with-application-virtualization-applications.md +- name: Troubleshooting UE-V + href: uev-troubleshooting.md +- name: Technical Reference for UE-V + items: + - name: Technical Reference for UE-V + href: uev-technical-reference.md + - name: Sync Methods for UE-V + href: uev-sync-methods.md + - name: Sync Trigger Events for UE-V + href: uev-sync-trigger-events.md + - name: Synchronizing Microsoft Office with UE-V + href: uev-synchronizing-microsoft-office-with-uev.md + - name: Application Template Schema Reference for UE-V + href: uev-application-template-schema-reference.md + - name: Security Considerations for UE-V + href: uev-security-considerations.md diff --git a/windows/configuration/ue-v/uev-administering-uev-with-windows-powershell-and-wmi.md b/windows/configuration/ue-v/uev-administering-uev-with-windows-powershell-and-wmi.md index c6c8c61462..69a9f649f1 100644 --- a/windows/configuration/ue-v/uev-administering-uev-with-windows-powershell-and-wmi.md +++ b/windows/configuration/ue-v/uev-administering-uev-with-windows-powershell-and-wmi.md @@ -7,10 +7,11 @@ ms.topic: article # Administering UE-V with Windows PowerShell and WMI - User Experience Virtualization (UE-V) provides Windows PowerShell cmdlets to help administrators perform various UE-V tasks. The following sections provide more information about using Windows PowerShell in UE-V. -> **Note**  Administering UE-V with Windows PowerShell requires PowerShell 3.0 or higher. For a complete list of UE-V cmdlets, see [User Experience Virtualization in Windows PowerShell](/powershell/module/uev/). +> [!NOTE] +> +> Administering UE-V with Windows PowerShell requires PowerShell 3.0 or higher. For a complete list of UE-V cmdlets, see [User Experience Virtualization in Windows PowerShell](/powershell/module/uev/). ## Managing the UE-V service and packages by using Windows PowerShell and WMI @@ -20,17 +21,6 @@ You can use Windows PowerShell and Windows Management Instrumentation (WMI) to m ## Managing UE-V settings location templates by using Windows PowerShell and WMI - After you create and deploy UE-V settings location templates, you can manage those templates by using Windows PowerShell or WMI. The following topic describes how to manage the settings location templates by using Windows PowerShell and WMI. [Managing UE-V Settings Location Templates Using Windows PowerShell and WMI](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md) - - - - - -## Related topics - -- [Administering UE-V](uev-administering-uev.md) - -- [User Experience Virtualization in Windows PowerShell](/powershell/module/uev/) diff --git a/windows/configuration/ue-v/uev-administering-uev.md b/windows/configuration/ue-v/uev-administering-uev.md index 98b270c7b2..9c5ff36c6a 100644 --- a/windows/configuration/ue-v/uev-administering-uev.md +++ b/windows/configuration/ue-v/uev-administering-uev.md @@ -7,64 +7,49 @@ ms.topic: article # Administering UE-V - After you finish deploying User Experience Virtualization (UE-V), you'll perform ongoing administrative tasks, such as managing the configuration of the UE-V service and recovering lost settings. These tasks are explained in the following sections. ## Managing UE-V configurations - In the course of the UE-V lifecycle, you'll manage the configuration of the UE-V service and also manage storage locations for resources such as settings package files. [Manage Configurations for UE-V](uev-manage-configurations.md) ## Working with custom UE-V templates and the UE-V template generator - This topic explains how to use the UE-V template generator and manage custom settings location templates. [Working with Custom UE-V Templates and the UE-V Template Generator](uev-working-with-custom-templates-and-the-uev-generator.md) ## Back up and restore application and Windows settings that are synchronized with UE-V - Windows Management Instrumentation (WMI) and Windows PowerShell features of UE-V allow you to restore settings packages. By using WMI and Windows PowerShell commands, you can restore application and Windows settings to their original state and restore other settings when a user adopts a new device. [Manage Administrative Backup and Restore in UE-V](uev-manage-administrative-backup-and-restore.md) ## Changing the frequency of UE-V scheduled tasks - You can configure the scheduled tasks that manage when UE-V checks for new or updated settings or for updated custom settings location templates in the settings template catalog. [Changing the Frequency of UE-V Scheduled Tasks](uev-changing-the-frequency-of-scheduled-tasks.md) ## Migrating UE-V settings packages - You can relocate the user settings packages either when they migrate to a new server or for backup purposes. [Migrating UE-V Settings Packages](uev-migrating-settings-packages.md) ## Using UE-V with Application Virtualization applications - You can use UE-V with Microsoft Application Virtualization (App-V) to share settings between virtual applications and installed applications across multiple computers. [Using UE-V with Application Virtualization Applications](uev-using-uev-with-application-virtualization-applications.md) ## Other resources for this feature - - [User Experience Virtualization for Windows overview](uev-for-windows.md) - - [Get Started with UE-V](uev-getting-started.md) - - [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) - - [Troubleshooting UE-V](uev-troubleshooting.md) - - [Technical Reference for UE-V](uev-technical-reference.md) - - - diff --git a/windows/configuration/ue-v/uev-application-template-schema-reference.md b/windows/configuration/ue-v/uev-application-template-schema-reference.md index 12da9b839a..3ae12c1b66 100644 --- a/windows/configuration/ue-v/uev-application-template-schema-reference.md +++ b/windows/configuration/ue-v/uev-application-template-schema-reference.md @@ -7,46 +7,32 @@ ms.topic: article # Application Template Schema Reference for UE-V - User Experience Virtualization (UE-V) uses XML settings location templates to define the desktop application settings and Windows settings that are captured and applied by UE-V. UE-V includes a set of default settings location templates. You can also create custom settings location templates with the UE-V template generator. An advanced user can customize the XML file for a settings location template. This topic details the XML structure of the UE-V settings location templates and provides guidance for editing these files. ## UE-V Application Template Schema Reference - This section details the XML structure of the UE-V settings location template and provides guidance for editing this file. ### In This Section - [XML Declaration and Encoding Attribute](#xml21) - - [Namespace and Root Element](#namespace21) - - [Data types](#data21) - - [Name Element](#name21) - - [ID Element](#id21) - - [Version Element](#version21) - - [Author Element](#author21) - - [Processes and Process Element](#processes21) - - [Application Element](#application21) - - [Common Element](#common21) - - [SettingsLocationTemplate Element](#settingslocationtemplate21) - - [Appendix: SettingsLocationTemplate.xsd](#appendix21) ### XML Declaration and Encoding Attribute **Mandatory: True** - **Type: String** The XML declaration must specify the XML version 1.0 attribute (<?xml version="1.0">). Settings location templates created by the UE-V template generator are saved in UTF-8 encoding, although the encoding isn't explicitly specified. We recommend that you include the encoding="UTF-8" attribute in this element as a best practice. All templates included with the product specify this tag as well (see the documents in %ProgramFiles%\\Microsoft User Experience Virtualization\\Templates for reference). For example: @@ -56,7 +42,6 @@ The XML declaration must specify the XML version 1.0 attribute (<?xml version ### Namespace and Root Element **Mandatory: True** - **Type: String** UE-V uses the `https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate` namespace for all applications. SettingsLocationTemplate is the root element and contains all other elements. Reference SettingsLocationTemplate in all templates using this tag: @@ -116,7 +101,7 @@ Path is consumed by RegistrySetting and FileSetting to refer to registry and fil Recursive indicates that the path and all subfolders are included for file settings or that all child registry keys are included for registry settings. In both cases, all items at the current level are included in the data captured. For a FileSettings object, all files within the specified folder are included in the data captured by UE-V but folders aren't included. For registry paths, all values in the current path are captured but child registry keys aren't captured. In both cases, care should be taken to avoid capturing large data sets or large numbers of items. -The DeleteIfNotFound attribute removes the setting from the user’s settings storage path data. This removal may be desirable in cases where removing these settings from the package will save a large amount of disk space on the settings storage path file server. +The DeleteIfNotFound attribute removes the setting from the user's settings storage path data. This removal may be desirable in cases where removing these settings from the package will save a large amount of disk space on the settings storage path file server. **FileMask** FileMask specifies only certain file types for the folder that is defined by Path. For example, Path might be `C:\users\username\files` and FileMask could be `*.txt` to include only text files. @@ -133,28 +118,24 @@ Settings is a container for all the settings that apply to a particular template |Element|Description| |--- |--- | |Asynchronous|Asynchronous settings packages are applied without blocking the application startup so that the application start proceeds while the settings are still being applied. This element is useful for settings that can be applied asynchronously, such as those settings get/set through an API, like SystemParameterSetting.| -|PreventOverlappingSynchronization|By default, UE-V only saves settings for an application when the last instance of an application using the template is closed. When this element is set to ‘false’, UE-V exports the settings even if other instances of an application are running. Suited templates - those templates that include a Common element section– that are shipped with UE-V use this flag to enable shared settings to always export on application close, while preventing application-specific settings from exporting until the last instance is closed.| +|PreventOverlappingSynchronization|By default, UE-V only saves settings for an application when the last instance of an application using the template is closed. When this element is set to 'false', UE-V exports the settings even if other instances of an application are running. Suited templates - those templates that include a Common element section– that are shipped with UE-V use this flag to enable shared settings to always export on application close, while preventing application-specific settings from exporting until the last instance is closed.| |AlwaysApplySettings|This parameter forces an imported settings package to be applied even if there are no differences between the package and the current state of the application. This parameter should be used only in special cases since it can slow down settings import.| ### Name Element **Mandatory: True** - **Type: String** Name specifies a unique name for the settings location template. This name is used for display purposes when referencing the template in WMI, PowerShell, Event Viewer and debug logs. In general, avoid referencing version information, as this referencing can be objected from the ProductVersion element. For example, specify `My Application` rather than `My Application 1.1`. > [!NOTE] -> UE-V does not reference external DTDs, so it's not possible to use named entities in a settings location template. For example, do not use ® to refer to the registered trade mark sign ®. Instead, use canonical numbered references to include these types of special characters, for example, &\#174 for the ® character. This rule applies to all string values in this document. +> UE-V does not reference external DTDs, so it's not possible to use named entities in a settings location template. For example, do not use ® to refer to the registered trade mark sign ®. Instead, use canonical numbered references to include these types of special characters, for example, &\#174 for the ® character. This rule applies to all string values in this document. See for a complete list of character entities. UTF-8-encoded documents may include the Unicode characters directly. Saving templates through the UE-V template generator converts character entities to their Unicode representations automatically. - - ### ID Element **Mandatory: True** - **Type: String** ID populates a unique identifier for a particular template. This tag becomes the primary identifier that the UE-V service uses to reference the template at runtime (for example, see the output of the Get-UevTemplate and Get-UevTemplateProgram PowerShell cmdlets). By convention, this tag shouldn't contain any spaces, which simplifies scripting. Version numbers of applications should be specified in this element to allow for easy identification of the template, such as `MicrosoftOffice2016Win64`. @@ -162,11 +143,8 @@ ID populates a unique identifier for a particular template. This tag becomes the ### Version Element **Mandatory: True** - **Type: Integer** - **Minimum Value: 0** - **Maximum Value: 2147483647** Version identifies the version of the settings location template for administrative tracking of changes. The UE-V template generator automatically increments this number by one each time the template is saved. Notice that this field must be a whole number integer; fractional values, such as `2.5` aren't allowed. @@ -190,17 +168,12 @@ Version identifies the version of the settings location template for administrat > This value is queried to determine if a new version of a template should be applied to an existing template in these instances: - When the scheduled Template Auto Update task executes - - When the Update-UevTemplate PowerShell cmdlet is executed - - When the microsoft\\uev:SettingsLocationTemplate Update method is called through WMI - - ### Author Element **Mandatory: False** - **Type: String** Author identifies the creator of the settings location template. Two optional child elements are supported: **Name** and **Email**. Both attributes are optional, but, if the Email child element is specified, it must be accompanied by the Name element. Author refers to the full name of the contact for the settings location template, and email should refer to an email address for the author. We recommend that you include this information in templates published publicly. @@ -208,7 +181,6 @@ Author identifies the creator of the settings location template. Two optional ch ### Processes and Process Element **Mandatory: True** - **Type: Element** Processes contain at least one `` element, which in turn contains the following child elements: **Filename**, **Architecture**, **ProductName**, **FileDescription**, **ProductVersion**, and **FileVersion**. The Filename child element is mandatory and the others are optional. A fully populated element contains tags similar to this example: @@ -220,16 +192,16 @@ Processes contain at least one `` element, which in turn contains the f MyApplication MyApplication.exe - - - - + + + + - - - - + + + + ``` @@ -237,7 +209,6 @@ Processes contain at least one `` element, which in turn contains the f ### Filename **Mandatory: True** - **Type: String** Filename refers to the actual file name of the executable as it appears in the file system. This element specifies the primary criterion that UE-V uses to evaluate whether a template applies to a process or not. This element must be specified in the settings location template XML. @@ -252,39 +223,30 @@ Valid filenames must not match the regular expression \[^\\\\\\?\\\*\\|<>/ A value of **True** indicates that the string contains illegal characters. Here are some examples of illegal values: - \\\\server\\share\\program.exe - - Program\*.exe - - Pro?ram.exe - - Program<1>.exe > [!NOTE] > The UE-V template generator encodes the greater than and less than characters as > and < respectively. - - -In rare circumstances, the FileName value won't necessarily include the .exe extension, but it should be specified as part of the value. For example, `MyApplication.exe` should be specified instead of `MyApplication`. The second example won't apply the template to the process if the actual name of the executable file is “MyApplication.exe”. +In rare circumstances, the FileName value won't necessarily include the .exe extension, but it should be specified as part of the value. For example, `MyApplication.exe` should be specified instead of `MyApplication`. The second example won't apply the template to the process if the actual name of the executable file is "MyApplication.exe". ### Architecture **Mandatory: False** - **Type: Architecture (String)** Architecture refers to the processor architecture for which the target executable was compiled. Valid values are Win32 for 32-bit applications or Win64 for 64-bit applications. If present, this tag limits the applicability of the settings location template to a particular application architecture. For an example of this applicability restriction, compare the %ProgramFiles%\\Microsoft User Experience Virtualization\\templates\\ MicrosoftOffice2016Win32.xml and MicrosoftOffice2016Win64.xml files included with UE-V. This applicability restriction is useful when relative paths change between different versions of an executable or if settings have been added or removed when moving from one processor architecture to another. -If this element is absent, the settings location template ignores the process’ architecture and applies to both 32-bit and 64-bit processes if the file name and other attributes apply. +If this element is absent, the settings location template ignores the process' architecture and applies to both 32-bit and 64-bit processes if the file name and other attributes apply. > [!NOTE] > UE-V does not support ARM processors in this version. - - ### ProductName **Mandatory: False** - **Type: String** ProductName is an optional element used to identify a product for administrative purposes or reporting. ProductName differs from Filename in that there are no regular expression restrictions on its value. This flexibility allows for more easily understood descriptions of a process where the executable name may not be obvious. For example: @@ -294,7 +256,7 @@ ProductName is an optional element used to identify a product for administrative MyApplication.exe My Application 6.x by Contoso.com - + ``` @@ -302,7 +264,6 @@ ProductName is an optional element used to identify a product for administrative ### FileDescription **Mandatory: False** - **Type: String** FileDescription is an optional tag that allows for an administrative description of the executable file. This tag is a free text field and can be useful in distinguishing multiple executables within a software package where there's a need to identify the function of the executable. @@ -332,7 +293,6 @@ For example, in a suited application, it might be useful to provide reminders ab ### ProductVersion **Mandatory: False** - **Type: String** ProductVersion refers to the major and minor product versions of a file, as well as a build and patch level. ProductVersion is an optional element, but if specified, it must contain at least the Major child element. The value must express a range in the form Minimum="X" Maximum="Y" where X and Y are integers. The Minimum and Maximum values can be identical. @@ -386,7 +346,6 @@ Only the Minor element is present. Major must be included as well. ### FileVersion **Mandatory: False** - **Type: String** FileVersion differentiates between the release version of a published application and the internal build details of a component executable. For most of the commercial applications, these numbers are identical. Where they vary, the product version of a file indicates a generic version identification of a file, while file version indicates a specific build of a file (as in the example of a hotfix or update). This file version uniquely identifies files without breaking detection logic. @@ -430,7 +389,6 @@ Application is a container for settings that apply to a particular application. |Processes|A container for a collection of one or more Process elements. For more information, see [Processes](#processes21).| |Settings|A container for all the settings that apply to a particular template. It contains instances of the Registry, File, SystemParameter, and CustomAction settings. For more information, see **Settings** in [Data types](#data21)".| - ### Common Element Common is similar to an Application element, but it's always associated with two or more Application elements. The Common section represents the set of settings that are shared between those Application instances. It's a collection of the following fields/types. @@ -460,7 +418,6 @@ This element defines the settings for a single application or a suite of applica |LocalizedNames|An optional name displayed in the UI, localized by a language locale.| |LocalizedDescriptions|An optional template description localized by a language locale.| - ### Appendix: SettingsLocationTemplate.xsd Here's the SettingsLocationTemplate.xsd file showing its elements, child elements, attributes, and parameters: @@ -782,12 +739,7 @@ Here's the SettingsLocationTemplate.xsd file showing its elements, child element ``` - - - - ## Related topics [Working with Custom UE-V Templates and the UE-V Template Generator](uev-working-with-custom-templates-and-the-uev-generator.md) - [Technical Reference for UE-V](uev-technical-reference.md) diff --git a/windows/configuration/ue-v/uev-changing-the-frequency-of-scheduled-tasks.md b/windows/configuration/ue-v/uev-changing-the-frequency-of-scheduled-tasks.md index 0e0636f653..27a6f934d1 100644 --- a/windows/configuration/ue-v/uev-changing-the-frequency-of-scheduled-tasks.md +++ b/windows/configuration/ue-v/uev-changing-the-frequency-of-scheduled-tasks.md @@ -7,15 +7,11 @@ ms.topic: article # Changing the Frequency of UE-V Scheduled Tasks - When the User Experience Virtualization (UE-V) service is enabled, it creates the following scheduled tasks: - [Monitor Application Settings](#monitor-application-settings) - - [Sync Controller Application](#sync-controller-application) - - [Synchronize Settings at Logoff](#synchronize-settings-at-logoff) - - [Template Auto Update](#template-auto-update) > [!NOTE] @@ -48,7 +44,7 @@ The **Sync Controller Application** task is used to start the Sync Controller to For example, the following command configures the agent to synchronize settings every 15 minutes instead of the default 30 minutes. ```console -Schtasks /change /tn “Microsoft\UE-V\Sync Controller Application” /ri 15 +Schtasks /change /tn "Microsoft\UE-V\Sync Controller Application" /ri 15 ``` ### Synchronize Settings at Logoff @@ -67,14 +63,12 @@ The **Template Auto Update** task checks the settings template catalog for new, |--- |--- | |\Microsoft\UE-V\Template Auto Update|System startup and at 3:30 AM every day, at a random time within a 1-hour window| - **Example:** The following command configures the UE-V service to check the settings template catalog store every hour. ```console schtasks /change /tn "Microsoft\UE-V\Template Auto Update" /ri 60 ``` - ## UE-V Scheduled Task Details The following chart provides additional information about scheduled tasks for UE-V 2: @@ -89,39 +83,27 @@ The following chart provides additional information about scheduled tasks for UE **Legend** - **Power Toggle** - Task Scheduler will optimize power consumption when not connected to AC power. The task might stop running if the computer switches to battery power. - - **Idle Only** - The task will stop running if the computer ceases to be idle. By default the task won't restart when the computer is idle again. Instead the task will begin again on the next task trigger. - -- **Network Connection** - Tasks marked “Yes” only run if the computer has a network connection available. Tasks marked “N/A” run regardless of network connectivity. +- **Network Connection** - Tasks marked "Yes" only run if the computer has a network connection available. Tasks marked "N/A" run regardless of network connectivity. ### How to Manage Scheduled Tasks To find Scheduled Tasks, perform the following steps: -1. Open “Schedule Tasks” on the user computer. - -2. Navigate to: Task Scheduler -> Task Scheduler Library -> Microsoft -> UE-V - -3. Select the scheduled task you wish to manage and configure in the details pane. +1. Open "Schedule Tasks" on the user computer. +1. Navigate to: Task Scheduler -> Task Scheduler Library -> Microsoft -> UE-V +1. Select the scheduled task you wish to manage and configure in the details pane. ### Additional information The following additional information applies to UE-V scheduled tasks: - All task sequence programs are located in the UE-V Agent installation folder, `%programFiles%\Microsoft User Experience Virtualization\Agent\[architecture]\`, by default. - -- The Sync Controller Application Scheduled task is the crucial component when the UE-V SyncMethod is set to “SyncProvider” (UE-V default configuration). This scheduled task keeps the SettingsSToragePath synchronized with the locally cached versions of the settings package files. If users complain that settings don't synchronize often enough, then you can reduce the scheduled task setting to as little as 1 minute. You can also increase the 30-min default to a higher amount if necessary. - -- You don't need to disable the Template Auto Update scheduled task if you use another method to keep the clients’ templates in sync (that is, Group Policy or Configuration Manager Baselines). Leaving the SettingsTemplateCatalog property value blank prevents UE-V from checking the settings catalog for custom templates. This scheduled task runs ApplySettingsCatalog.exe and will essentially return immediately. - +- The Sync Controller Application Scheduled task is the crucial component when the UE-V SyncMethod is set to "SyncProvider" (UE-V default configuration). This scheduled task keeps the SettingsSToragePath synchronized with the locally cached versions of the settings package files. If users complain that settings don't synchronize often enough, then you can reduce the scheduled task setting to as little as 1 minute. You can also increase the 30-min default to a higher amount if necessary. +- You don't need to disable the Template Auto Update scheduled task if you use another method to keep the clients' templates in sync (that is, Group Policy or Configuration Manager Baselines). Leaving the SettingsTemplateCatalog property value blank prevents UE-V from checking the settings catalog for custom templates. This scheduled task runs ApplySettingsCatalog.exe and will essentially return immediately. - The Monitor Application Settings scheduled task will update Windows app (AppX) settings in real time, based on Windows app program setting triggers built into each app. - - - - ## Related topics [Administering UE-V](uev-administering-uev.md) - [Deploy UE-V for Custom Applications](uev-deploy-uev-for-custom-applications.md) diff --git a/windows/configuration/ue-v/uev-configuring-uev-with-group-policy-objects.md b/windows/configuration/ue-v/uev-configuring-uev-with-group-policy-objects.md index cd4155a237..805ceed27e 100644 --- a/windows/configuration/ue-v/uev-configuring-uev-with-group-policy-objects.md +++ b/windows/configuration/ue-v/uev-configuring-uev-with-group-policy-objects.md @@ -7,13 +7,11 @@ ms.topic: article # Configuring UE-V with Group Policy Objects - -Some User Experience Virtualization (UE-V) Group Policy settings can be defined for computers, and other Group Policy settings can be defined for users. The Group Policy administrative templates for these settings are included in Windows 10, version 1607. - +Some User Experience Virtualization (UE-V) Group Policy settings can be defined for computers, and other Group Policy settings can be defined for users. The Group Policy administrative templates for these settings are included in Windows 10, version 1607. The following policy settings can be configured for UE-V. -**Group Policy settings** +### Group Policy settings |Group Policy setting name|Target|Group Policy setting description|Configuration options| |--- |--- |--- |--- | @@ -33,47 +31,36 @@ The following policy settings can be configured for UE-V. >[!NOTE] >In addition, Group Policy settings are available for many desktop applications and Windows apps. You can use these settings to enable or disable settings synchronization for specific applications. -**Windows App Group Policy settings** +### Windows App Group Policy settings |Group Policy setting name|Target|Group Policy setting description|Configuration options| |--- |--- |--- |--- | |Do not synchronize Windows Apps|Computers and Users|This Group Policy setting defines whether the UE-V service synchronizes settings for Windows apps.|The default is to synchronize Windows apps.| -|Windows App List|Computer and User|This setting lists the family package names of the Windows apps and states expressly whether UE-V synchronizes that app’s settings.|You can use this setting to specify that settings of an app are never synchronized by UE-V, even if the settings of all other Windows apps are synchronized.| +|Windows App List|Computer and User|This setting lists the family package names of the Windows apps and states expressly whether UE-V synchronizes that app's settings.|You can use this setting to specify that settings of an app are never synchronized by UE-V, even if the settings of all other Windows apps are synchronized.| |Sync Unlisted Windows Apps|Computer and User|This Group Policy setting defines the default settings sync behavior of the UE-V service for Windows apps that are not explicitly listed in the Windows app list.|By default, the UE-V service only synchronizes settings of those Windows apps that are included in the Windows app list.| For more information about synchronizing Windows apps, see [Windows App List](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md#win8applist). **To configure computer-targeted Group Policy settings** -1. Use the Group Policy Management Console (GPMC) or the Advanced Group Policy Management (AGPM) on the computer that acts as a domain controller to manage Group Policy settings for UE-V computers. Navigate to **Computer configuration**, select **Policies**, select **Administrative Templates**, click **Windows Components**, and then select **Microsoft User Experience Virtualization**. - -2. Select the Group Policy setting to be edited. +1. Use the Group Policy Management Console (GPMC) or the Advanced Group Policy Management (AGPM) on the computer that acts as a domain controller to manage Group Policy settings for UE-V computers. Navigate to **Computer configuration**, select **Policies**, select **Administrative Templates**, click **Windows Components**, and then select **Microsoft User Experience Virtualization** +1. Select the Group Policy setting to be edited **To configure user-targeted Group Policy settings** -1. Use the Group Policy Management Console (GPMC) or the Advanced Group Policy Management (AGPM) tool in Microsoft Desktop Optimization Pack (MDOP) on the domain controller computer to manage Group Policy settings for UE-V. Navigate to **User configuration**, select **Policies**, select **Administrative Templates**, click **Windows Components**, and then select **Microsoft User Experience Virtualization**. - -2. Select the edited Group Policy setting. +1. Use the Group Policy Management Console (GPMC) or the Advanced Group Policy Management (AGPM) tool in Microsoft Desktop Optimization Pack (MDOP) on the domain controller computer to manage Group Policy settings for UE-V. Navigate to **User configuration**, select **Policies**, select **Administrative Templates**, click **Windows Components**, and then select **Microsoft User Experience Virtualization** +1. Select the edited Group Policy setting The UE-V service uses the following order of precedence to determine synchronization. **Order of precedence for UE-V settings** -1. User-targeted settings that are managed by Group Policy settings - These configuration settings are stored in the registry key by Group Policy under `HKEY_CURRENT_USER\Software\Policies\Microsoft\Uev\Agent\Configuration`. - -2. Computer-targeted settings that are managed by Group Policy settings - These configuration settings are stored in the registry key by Group Policy under `HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Uev\Agent\Configuration`. - -3. Configuration settings that are defined by the current user by using Windows PowerShell or Windows management Instrumentation (WMI) - These configuration settings are stored by the UE-V service under this registry location: `HKEY_CURRENT_USER\Software\Microsoft\Uev\Agent\Configuration`. - -4. Configuration settings that are defined for the computer by using Windows PowerShell or WMI. These configuration settings are stored by the UE-V service under this registry location: `HKEY_LOCAL_MACHINE\Software\Microsoft\Uev\Agent\Configuration`. - - - - +1. User-targeted settings that are managed by Group Policy settings - These configuration settings are stored in the registry key by Group Policy under `HKEY_CURRENT_USER\Software\Policies\Microsoft\Uev\Agent\Configuration` +1. Computer-targeted settings that are managed by Group Policy settings - These configuration settings are stored in the registry key by Group Policy under `HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Uev\Agent\Configuration` +1. Configuration settings that are defined by the current user by using Windows PowerShell or Windows management Instrumentation (WMI) - These configuration settings are stored by the UE-V service under this registry location: `HKEY_CURRENT_USER\Software\Microsoft\Uev\Agent\Configuration` +1. Configuration settings that are defined for the computer by using Windows PowerShell or WMI. These configuration settings are stored by the UE-V service under this registry location: `HKEY_LOCAL_MACHINE\Software\Microsoft\Uev\Agent\Configuration` ## Related topics - [Administering UE-V](uev-administering-uev.md) - [Manage Configurations for UE-V](uev-manage-configurations.md) diff --git a/windows/configuration/ue-v/uev-configuring-uev-with-system-center-configuration-manager.md b/windows/configuration/ue-v/uev-configuring-uev-with-system-center-configuration-manager.md index 8d1882168b..d2a1f7a535 100644 --- a/windows/configuration/ue-v/uev-configuring-uev-with-system-center-configuration-manager.md +++ b/windows/configuration/ue-v/uev-configuring-uev-with-system-center-configuration-manager.md @@ -7,7 +7,6 @@ ms.topic: article # Configuring UE-V with Microsoft Configuration Manager - After you deploy User Experience Virtualization (UE-V) and its required features, you can start to configure it to meet your organization's need. The UE-V Configuration Pack provides a way for administrators to use the Compliance Settings feature of Microsoft Configuration Manager to apply consistent configurations across sites where UE-V and Configuration Manager are installed. ## UE-V Configuration Pack supported features @@ -15,124 +14,101 @@ After you deploy User Experience Virtualization (UE-V) and its required features The UE-V Configuration Pack includes tools to: - Create or update UE-V settings location template distribution baselines - - - Define UE-V templates to be registered or unregistered - - - Update UE-V template configuration items and baselines as templates are added or updated - - - Distribute and register UE-V templates using standard Configuration Item remediation - + - Define UE-V templates to be registered or unregistered + - Update UE-V template configuration items and baselines as templates are added or updated + - Distribute and register UE-V templates using standard Configuration Item remediation - Create or update a UE-V Agent policy configuration item to set or clear these settings - |Configuration|Setting|Description| - |--- |--- |--- | - |Max package size|Enable/disable Windows app sync|Wait for sync on application start| - |Setting import delay|Sync unlisted Windows apps|Wait for sync on sign in| - |Settings import notification|IT contact URL|Wait for sync timeout| - |Settings storage path|IT contact descriptive text|Settings template catalog path| - |Sync enablement|Tray icon enabled|Start/Stop UE-V agent service| - |Sync method|First use notification|Define which Windows apps will roam settings| - |Sync timeout||| + |Configuration|Setting|Description| + |--- |--- |--- | + |Max package size|Enable/disable Windows app sync|Wait for sync on application start| + |Setting import delay|Sync unlisted Windows apps|Wait for sync on sign in| + |Settings import notification|IT contact URL|Wait for sync timeout| + |Settings storage path|IT contact descriptive text|Settings template catalog path| + |Sync enablement|Tray icon enabled|Start/Stop UE-V agent service| + |Sync method|First use notification|Define which Windows apps will roam settings| + |Sync timeout||| - Verify compliance by confirming that UE-V is running. ## Generate a UE-V service policy configuration item - All UE-V service policy and configuration is distributed through a single configuration item that is generated using the UevAgentPolicyGenerator.exe tool. This tool reads the desired configuration from an XML configuration file and creates a CI containing the discovery and remediation settings needed to bring the machine into compliance. The UE-V service policy configuration item CAB file is created using the UevTemplateBaselineGenerator.exe command line tool, which has these parameters: - Site <site code> - -- PolicyName <name> Optional: Defaults to “UE-V Agent Policy” if not present - +- PolicyName <name> Optional: Defaults to "UE-V Agent Policy" if not present - PolicyDescription <description> Optional: A description is provided if not present - - CabFilePath <full path to configuration item .CAB file> - - ConfigurationFile <full path to agent configuration XML file> > [!NOTE] > It might be necessary to change the PowerShell execution policy to allow these scripts to run in your environment. Perform these steps in the Configuration Manager console: -1. Select **Administration > Client Settings > Properties** - -2. In the **User Agent** tab, set the **PowerShell Execution Policy** to **Bypass** - +1. Select **Administration > Client Settings > Properties** +1. In the **User Agent** tab, set the **PowerShell Execution Policy** to **Bypass** **Create the first UE-V policy configuration item** -1. Copy the default settings configuration file from the UE-V Config Pack installation directory to a location visible to your ConfigMgr Admin Console: +1. Copy the default settings configuration file from the UE-V Config Pack installation directory to a location visible to your ConfigMgr Admin Console: - ```cmd - C:\Program Files (x86)\Windows Kits\10\Microsoft User Experience Virtualization\Management\AgentConfiguration.xml + ```cmd + C:\Program Files (x86)\Windows Kits\10\Microsoft User Experience Virtualization\Management\AgentConfiguration.xml + ``` + + The default configuration file contains five sections: + + **Computer Policy** + + All UE-V machine level settings. The DesiredState attribute can be + + - **Set** to have the value assigned in the registry + - **Clear** to remove the setting + - **Unmanaged** to have the configuration item left at its current state + + Don't remove lines from this section. Instead, set the DesiredState to `Unmanaged` if you don't want Configuration Manager to alter current or default values. + + **CurrentComputerUserPolicy** + + All UE-V user level settings. These entries override the machine settings for a user. The DesiredState attribute can be + + - **Set** to have the value assigned in the registry + - **Clear** to remove the setting + - **Unmanaged** to have the configuration item left at its current state + + Don't remove lines from this section. Instead, set the DesiredState to 'Unmanaged' if you don't want Configuration Manager to alter current or default values. + + **Services** + + Entries in this section control service operation. The default configuration file contains a single entry for the UevAgentService. The DesiredState attribute can be set to **Running** or **Stopped**. + + **Windows8AppsComputerPolicy** + + All machine level Windows app synchronization settings. Each PackageFamilyName listed in this section can be assigned a DesiredState of + + - **Enabled** to have settings roam + - **Disabled** to prevent settings from roaming + - **Cleared** to have the entry removed from UE-V control + + More lines can be added to this section based on the list of installed Windows apps that can be viewed using the PowerShell cmdlet GetAppxPackage. + + **Windows8AppsCurrentComputerUserPolicy** + + Identical to the Windows8AppsComputerPolicy with settings that override machine settings for an individual user. - ``` - - The default configuration file contains five sections: - - **Computer Policy** - - All UE-V machine level settings. The DesiredState attribute can be - - - **Set** to have the value assigned in the registry - - - **Clear** to remove the setting - - - **Unmanaged** to have the configuration item left at its current state - - Don't remove lines from this section. Instead, set the DesiredState to ‘Unmanaged’ if you don't want Configuration Manager to alter current or default values. - - **CurrentComputerUserPolicy** - - All UE-V user level settings. These entries override the machine settings for a user. The DesiredState attribute can be - - - **Set** to have the value assigned in the registry - - - **Clear** to remove the setting - - - **Unmanaged** to have the configuration item left at its current state - - Don't remove lines from this section. Instead, set the DesiredState to ‘Unmanaged’ if you don't want Configuration Manager to alter current or default values. - - **Services** - - Entries in this section control service operation. The default configuration file contains a single entry for the UevAgentService. The DesiredState attribute can be set to **Running** or **Stopped**. - - **Windows8AppsComputerPolicy** - - All machine level Windows app synchronization settings. Each PackageFamilyName listed in this section can be assigned a DesiredState of - - - **Enabled** to have settings roam - - - **Disabled** to prevent settings from roaming - - - **Cleared** to have the entry removed from UE-V control - - More lines can be added to this section based on the list of installed Windows apps that can be viewed using the PowerShell cmdlet GetAppxPackage. - - **Windows8AppsCurrentComputerUserPolicy** - - Identical to the Windows8AppsComputerPolicy with settings that override machine settings for an individual user. - -2. Edit the configuration file by changing the desired state and value fields. - -3. Run this command on a machine running the ConfigMgr Admin Console: - - ```cmd - C:\Program Files (x86)\Microsoft User Experience Virtualization\ConfigPack\UevAgentPolicyGenerator.exe -Site ABC -CabFilePath "C:\MyCabFiles\UevPolicyItem.cab" -ConfigurationFile "c:\AgentConfiguration.xml" - ``` - -4. Import the CAB file using ConfigMgr console or PowerShell Import-CMConfigurationItem +1. Edit the configuration file by changing the desired state and value fields. +1. Run this command on a machine running the ConfigMgr Admin Console: + ```cmd + C:\Program Files (x86)\Microsoft User Experience Virtualization\ConfigPack\UevAgentPolicyGenerator.exe -Site ABC -CabFilePath "C:\MyCabFiles\UevPolicyItem.cab" -ConfigurationFile "c:\AgentConfiguration.xml" + ``` +1. Import the CAB file using ConfigMgr console or PowerShell Import-CMConfigurationItem **Update a UE-V Policy Configuration Item** -1. Edit the configuration file by changing the desired state and value fields. - -2. Run the command from Step 3 in [Create the First UE-V Policy Configuration Item](#create). If you changed the name with the PolicyName parameter, make sure you enter the same name. - -3. Reimport the CAB file. The version in ConfigMgr will be updated. +1. Edit the configuration file by changing the desired state and value fields. +1. Run the command from Step 3 in [Create the First UE-V Policy Configuration Item](#create). If you changed the name with the PolicyName parameter, make sure you enter the same name. +1. Reimport the CAB file. The version in ConfigMgr will be updated. ## Generate a UE-V Template Baseline @@ -141,34 +117,24 @@ UE-V templates are distributed using a baseline containing multiple configuratio The UE-V template baseline is created using the UevTemplateBaselineGenerator.exe command line tool, which has these parameters: - Site <site code> - -- BaselineName <name> (Optional: defaults to “UE-V Template Distribution Baseline” if not present) - +- BaselineName <name> (Optional: defaults to "UE-V Template Distribution Baseline" if not present) - BaselineDescription <description> (Optional: a description is provided if not present) - - TemplateFolder <UE-V template folder> - - Register <comma separated template file list> - - Unregister <comma separated template list> - - CabFilePath <Full path to baseline CAB file to generate> The result is a baseline CAB file that is ready for import into Configuration Manager. If at a future date, you update or add a template, you can rerun the command using the same baseline name. Importing the CAB results in CI version updates on the changed templates. ### Create the First UE-V Template Baseline -1. Create a “master” set of UE-V templates in a stable folder location visible to the machine running your ConfigMgr Admin Console. As templates are added or updated, this folder is where they're pulled for distribution. The initial list of templates can be copied from a machine with UE-V installed. The default template location is C:\\Program Files\\Microsoft User Experience Virtualization\\Templates. - -2. Create a text.bat file where you can add the template generator command. This step is optional, but will make regeneration simpler if you save the command parameters. - -3. Add the command and parameters to the .bat file that will generate the baseline. The following example creates a baseline that distributes Notepad and Calculator: - - ```cmd - C:\Program Files (x86)\Microsoft User Experience Virtualization\ConfigPack\UevTemplateBaselineGenerator.exe -Site "ABC" -TemplateFolder "C:\ProductionUevTemplates" -Register "MicrosoftNotepad.xml, MicrosoftCalculator.xml" -CabFilePath "C:\MyCabFiles\UevTemplateBaseline.cab" - ``` - -4. Run the .bat file to create UevTemplateBaseline.cab ready for import into Configuration Manager. +1. Create a "master" set of UE-V templates in a stable folder location visible to the machine running your ConfigMgr Admin Console. As templates are added or updated, this folder is where they're pulled for distribution. The initial list of templates can be copied from a machine with UE-V installed. The default template location is C:\\Program Files\\Microsoft User Experience Virtualization\\Templates. +1. Create a text.bat file where you can add the template generator command. This step is optional, but will make regeneration simpler if you save the command parameters +1. Add the command and parameters to the .bat file that will generate the baseline. The following example creates a baseline that distributes Notepad and Calculator: + ```cmd + C:\Program Files (x86)\Microsoft User Experience Virtualization\ConfigPack\UevTemplateBaselineGenerator.exe -Site "ABC" -TemplateFolder "C:\ProductionUevTemplates" -Register "MicrosoftNotepad.xml, MicrosoftCalculator.xml" -CabFilePath "C:\MyCabFiles\UevTemplateBaseline.cab" + ``` +1. Run the .bat file to create UevTemplateBaseline.cab ready for import into Configuration Manager ### Update a UE-V Template Baseline @@ -176,15 +142,11 @@ The template generator uses the template version to determine if a template shou To distribute a new Notepad template, you would perform these steps: -1. Update the template and template version located in the <Version> element of the template. - -2. Copy the template to your master template directory. - -3. Run the command in the .bat file that you created in Step 3 in [Create the First UE-V Template Baseline](#create2). - -4. Import the generated CAB file into ConfigMgr using the console or PowerShell Import-CMBaseline. +1. Update the template and template version located in the <Version> element of the template +1. Copy the template to your master template directory +1. Run the command in the .bat file that you created in Step 3 in [Create the First UE-V Template Baseline](#create2) +1. Import the generated CAB file into ConfigMgr using the console or PowerShell Import-CMBaseline ## Related articles - [Manage Configurations for UE-V](uev-manage-configurations.md) diff --git a/windows/configuration/ue-v/uev-deploy-required-features.md b/windows/configuration/ue-v/uev-deploy-required-features.md index b23bd1c337..c336528990 100644 --- a/windows/configuration/ue-v/uev-deploy-required-features.md +++ b/windows/configuration/ue-v/uev-deploy-required-features.md @@ -7,19 +7,13 @@ ms.topic: article # Deploy required UE-V features - To get up and running with User Experience Virtualization (UE-V), install and configure the following features. - [Deploy a settings storage location](#deploy-a-ue-v-settings-storage-location) that is accessible to end users. - This feature is a standard network share that stores and retrieves user settings. - - [Choose the configuration method for UE-V](#choose-the-configuration-method-for-ue-v) - You can deploy and configure UE-V with common management tools including group policy, Configuration Manager, or Windows Management Infrastructure and PowerShell. - - [Enable the UE-V service](#enable-the-ue-v-service) on user devices. - With Windows 10, version 1607, UE-V is installed automatically. You need to enable the UE-V service on each user device you want to include in your UE-V environment. The articles in this section describe how to deploy these features. @@ -29,10 +23,10 @@ The articles in this section describe how to deploy these features. UE-V requires a location in which to store user settings in settings package files. You can configure this settings storage location in one of these ways: - Create your own settings storage location - - Use existing Active Directory for your settings storage location -> **Note**   As a matter of [performance and capacity planning](uev-prepare-for-deployment.md#performance-and-capacity-planning) and to reduce problems with network latency, create settings storage locations on the same local networks where the users’ devices reside. We recommend 20 MB of disk space per user for the settings storage location. +> [!NOTE] +> As a matter of [performance and capacity planning](uev-prepare-for-deployment.md#performance-and-capacity-planning) and to reduce problems with network latency, create settings storage locations on the same local networks where the users' devices reside. We recommend 20 MB of disk space per user for the settings storage location. ### Create a UE-V Settings Storage Location @@ -41,15 +35,12 @@ Before you define the settings storage location, you must create a root director The settings storage location is defined by setting the SettingsStoragePath configuration option, which you can configure by using one of these methods: - Through [Group Policy](uev-configuring-uev-with-group-policy-objects.md) settings - - With the [Configuration Manager Pack](uev-configuring-uev-with-system-center-configuration-manager.md) for UE-V - - With [Windows PowerShell or Windows Management Instrumentation (WMI)](uev-administering-uev-with-windows-powershell-and-wmi.md) - The path must be in a universal naming convention (UNC) path of the server and share. For example, **\\\\Server\\Settingsshare\\**. This configuration option supports the use of variables to enable specific synchronization scenarios. For example, you can use the %username%\\%computername% variables to preserve the end user settings experience in these scenarios: + The path must be in a universal naming convention (UNC) path of the server and share. For example, **\\Server\Settingsshare\**. This configuration option supports the use of variables to enable specific synchronization scenarios. For example, you can use the %username%\%computername% variables to preserve the end user settings experience in these scenarios: - End users that use multiple physical devices in your enterprise - - Enterprise computers that are used by multiple end users The UE-V service dynamically creates a user-specific settings storage path, with a hidden system folder named **SettingsPackages**, based on the configuration setting of **SettingsStoragePath**. The service reads and writes settings to this location as defined by the registered UE-V settings location templates. @@ -60,18 +51,16 @@ The UE-V service dynamically creates a user-specific settings storage path, with **To deploy the UE-V network share** -1. Create a new security group for UE-V users. - -2. Create a new folder on the centrally located computer that stores the UE-V settings packages, and then grant UE-V users access with group permissions to the folder. The administrator who supports UE-V must have permissions to this shared folder. - -3. Set the following share-level Server Message Block (SMB) permissions for the settings storage location folder. +1. Create a new security group for UE-V users. +1. Create a new folder on the centrally located computer that stores the UE-V settings packages, and then grant UE-V users access with group permissions to the folder. The administrator who supports UE-V must have permissions to this shared folder. +1. Set the following share-level Server Message Block (SMB) permissions for the settings storage location folder. | **User account** | **Recommended permissions** | |------------------------------|-----------------------------| | Everyone | No permissions | | Security group of UE-V users | Full control | -4. Set the following NTFS file system permissions for the settings storage location folder. +1. Set the following NTFS file system permissions for the settings storage location folder. | **User account** | **Recommended permissions** | **Folder** | |------------------------------|---------------------------------------------------|---------------------------| @@ -80,78 +69,63 @@ The UE-V service dynamically creates a user-specific settings storage path, with With this configuration, the UE-V service creates and secures a Settingspackage folder while it runs in the context of the user, and grants each user permission to create folders for settings storage. Users receive full control to their Settingspackage folder while other users can't access it. -**Note** -If you create the settings storage share on a computer running a Windows Server operating system, configure UE-V to verify that either the local Administrators group or the current user is the owner of the folder where settings packages are stored. To enable this extra security, specify this setting in the Windows Server Registry Editor: - -1. Add a **REG\_DWORD** registry key named **"RepositoryOwnerCheckEnabled"** to **HKEY\_LOCAL\_MACHINE\\Software\\Microsoft\\UEV\\Agent\\Configuration**. - -2. Set the registry key value to *1*. +> [!NOTE] +> If you create the settings storage share on a computer running a Windows Server operating system, configure UE-V to verify that either the local Administrators group or the current user is the owner of the folder where settings packages are stored. To enable this extra security, specify this setting in the Windows Server Registry Editor: +> +> 1. Add a **REG_DWORD** registry key named **"RepositoryOwnerCheckEnabled"** to **HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration** +> 1. Set the registry key value to *1* ### Use Active Directory with UE-V -The UE-V service uses Active Directory (AD) by default if you don’t define a settings storage location. In these cases, the UE-V service dynamically creates the settings storage folder under the root of the AD home directory of each user. However, if a custom directory setting is configured in AD, then that directory is used instead. +The UE-V service uses Active Directory (AD) by default if you don't define a settings storage location. In these cases, the UE-V service dynamically creates the settings storage folder under the root of the AD home directory of each user. However, if a custom directory setting is configured in AD, then that directory is used instead. ## Choose the Configuration Method for UE-V -You’ll need to decide which configuration method you'll use to manage UE-V after deployment since this configuration method is the one you'll use to deploy the UE-V Agent. Typically, this configuration method is the one that you already use in your environment, such as Windows PowerShell or Configuration Manager. +You'll need to decide which configuration method you'll use to manage UE-V after deployment since this configuration method is the one you'll use to deploy the UE-V Agent. Typically, this configuration method is the one that you already use in your environment, such as Windows PowerShell or Configuration Manager. You can configure UE-V before, during, or after you enable the UE-V service on user devices, depending on the configuration method that you use. - [**Group Policy**](uev-configuring-uev-with-group-policy-objects.md) You can use your existing Group Policy infrastructure to configure UE-V before or after you enable the UE-V service. The UE-V Group Policy ADMX template enables the central management of common UE-V service configuration options and includes settings to configure UE-V synchronization. - >**Note** Starting with Windows 10, version 1607, UE-V ADMX templates are installed automatically. + > [!NOTE] + > Starting with Windows 10, version 1607, UE-V ADMX templates are installed automatically. Group Policy ADMX templates configure the synchronization settings for the UE-V service and enable the central management of common UE-V service configuration settings by using an existing Group Policy infrastructure. - Supported operating systems for the domain controller that deploys the Group Policy Objects include: - Windows Server 2012 and Windows Server 2012 R2 - [**Configuration Manager**](uev-configuring-uev-with-system-center-configuration-manager.md) The UE-V Configuration Pack lets you use the Compliance Settings feature of Microsoft Configuration Manager to apply consistent configurations across sites where UE-V and Configuration Manager are installed. - - [**Windows PowerShell and WMI**](uev-administering-uev-with-windows-powershell-and-wmi.md) You can use scripted commands for Windows PowerShell and Windows Management Instrumentation (WMI) to modify the configuration of the UE-V service. ->**Note** -Registry modification can result in data loss, or the computer becomes unresponsive. We recommend that you use other configuration methods. +> [!NOTE] +> Registry modification can result in data loss, or the computer becomes unresponsive. We recommend that you use other configuration methods. ## Enable the UE-V service The UE-V service is the client-side component that captures user-personalized application and Windows settings and saves them in settings packages. Settings packages are built, locally stored, and copied to the settings storage location. -Before enabling the UE-V service, you need to register the UE-V templates for first time use. In a PowerShell window, type **register-<TemplateName>** where **TemplateName** is the name of the UE-V template you want to register, and press ENTER. +Before enabling the UE-V service, you need to register the UE-V templates for first time use. In a PowerShell window, type **register-<TemplateName>** where **TemplateName** is the name of the UE-V template you want to register, and press ENTER. ->**Note** -With Windows 10, version 1607, you must register UE-V templates for all inbox and custom templates. This provides flexibility for only deploying the required templates. +> [!NOTE] +> With Windows 10, version 1607, you must register UE-V templates for all inbox and custom templates. This provides flexibility for only deploying the required templates. With Windows 10, version 1607 and later, the UE-V service is installed on user devices. Enable the service to start using UE-V. You can enable the service with the Group Policy editor or with Windows PowerShell. **To enable the UE-V service with Group Policy** -1. Open the device’s **Group Policy Editor**. - -2. Navigate to **Computer Configuration** > **Administrative Templates** > **Windows Components** > **Microsoft** **User Experience Virtualization**. - -3. Run **Enable UEV**. - -4. Restart the device. +1. Open the device's **Group Policy Editor** +1. Navigate to **Computer Configuration** > **Administrative Templates** > **Windows Components** > **Microsoft** **User Experience Virtualization** +1. Run **Enable UEV** +1. Restart the device **To enable the UE-V service with Windows PowerShell** -1. In a PowerShell window, type **Enable-UEV** and press ENTER. - -2. Restart the device. - -3. In a PowerShell window, type **Get-UEVStatus** and press ENTER to verify that the UE-V service was successfully enabled. - - - - +1. In a PowerShell window, type **Enable-UEV** and press ENTER +1. Restart the device +1. In a PowerShell window, type **Get-UEVStatus** and press ENTER to verify that the UE-V service was successfully enabled ## Related articles [Prepare a UE-V deployment](uev-prepare-for-deployment.md) - [Deploy UE-V for use with custom applications](uev-deploy-uev-for-custom-applications.md) - [Upgrade to UE-V for Windows 10](uev-upgrade-uev-from-previous-releases.md) - diff --git a/windows/configuration/ue-v/uev-deploy-uev-for-custom-applications.md b/windows/configuration/ue-v/uev-deploy-uev-for-custom-applications.md index 8cef71005b..1bdeadf3a0 100644 --- a/windows/configuration/ue-v/uev-deploy-uev-for-custom-applications.md +++ b/windows/configuration/ue-v/uev-deploy-uev-for-custom-applications.md @@ -5,39 +5,28 @@ ms.date: 04/19/2017 ms.topic: article --- -# Use UE-V with custom applications - +# Use UE-V with custom applications User Experience Virtualization (UE-V) uses XML files called ***settings location templates*** to monitor and synchronize application settings and Windows settings between user devices. By default, some settings location templates are included in UE-V. However, if you want to synchronize settings for desktop applications other than those settings included in the default templates, you can create your own custom settings location templates with the UE-V template generator. -After you’ve reviewed [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) and decided that you want to synchronize settings for custom applications (for example, third-party, line-of-business), you’ll need to deploy the features of UE-V described in this topic. +After you've reviewed [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) and decided that you want to synchronize settings for custom applications (for example, third-party, line-of-business), you'll need to deploy the features of UE-V described in this topic. To start, here are the main steps required to synchronize settings for custom applications: - [Install the UE-V template generator](#install-the-uev-template-generator) - Use the UEV template generator to create custom XML settings location templates. - - [Configure a UE-V settings template catalog](#deploy-a-settings-template-catalog) - You can define this path where custom settings location templates are stored. - - [Create custom settings location templates](#create-custom-settings-location-templates) - These custom templates let users sync settings for custom applications. - - [Deploy the custom settings location templates](#deploy-the-custom-settings-location-templates) - After you test the custom template to ensure that settings are synced correctly, you can deploy these templates in one of these ways: - - With your existing electronic software distribution solution, such as Configuration Manager - - With Group Policy preferences - - With a UE-V settings template catalog ->**Note** -Templates that are deployed with electronic software distribution methods or Group Policy must be registered with UE-V Windows Management Instrumentation (WMI) or Windows PowerShell. +> [!NOTE] +> Templates that are deployed with electronic software distribution methods or Group Policy must be registered with UE-V Windows Management Instrumentation (WMI) or Windows PowerShell. ## Prepare to deploy UE-V for custom applications @@ -48,28 +37,20 @@ Before you start deploying the UE-V features that handle custom applications, re Use the UE-V template generator to monitor, discover, and capture the locations where Win32 applications store settings. The template generator doesn't create settings location templates for the following types of applications: - Virtualized applications - - Applications that are offered through Terminal Services - - Java applications - - Windows applications ->**Note** -UE-V settings location templates can't be created from virtualized applications or Terminal Services applications. However, settings that are synchronized by using the templates can be applied to those applications. To create templates that support Virtual Desktop Infrastructure (VDI) and Terminal Services applications, open a version of the Windows Installer (.msi) package of the application by using the UE-V template generator. For more information about synchronizing settings for virtual applications, see [Using UE-V with virtual applications](uev-using-uev-with-application-virtualization-applications.md). +> [!NOTE] +> UE-V settings location templates can't be created from virtualized applications or Terminal Services applications. However, settings that are synchronized by using the templates can be applied to those applications. To create templates that support Virtual Desktop Infrastructure (VDI) and Terminal Services applications, open a version of the Windows Installer (.msi) package of the application by using the UE-V template generator. For more information about synchronizing settings for virtual applications, see [Using UE-V with virtual applications](uev-using-uev-with-application-virtualization-applications.md). **Excluded Locations:** The discovery process excludes locations that commonly store application software files that don't synchronize settings well between user computers or computing environments. By default, these files are excluded: -- HKEY\_CURRENT\_USER registry keys and files to which the signed-in user can't write values - -- HKEY\_CURRENT\_USER registry keys and files that are associated with the core functionality of the Windows operating system - -- All registry keys that are located in the HKEY\_LOCAL\_MACHINE hive - +- HKEY_CURRENT_USER registry keys and files to which the signed-in user can't write values +- HKEY_CURRENT_USER registry keys and files that are associated with the core functionality of the Windows operating system +- All registry keys that are located in the HKEY_LOCAL_MACHINE hive - Files that are located in Program Files directories - -- Files that are located in Users \\ \[User name\] \\ AppData \\ LocalLow - +- Files that are located in Users \ [User name] \ AppData \ LocalLow - Windows operating system files that are located in %Systemroot% If registry keys and files that are stored in excluded locations are required to synchronize application settings, you can manually add the locations to the settings location template during the template creation process. @@ -78,13 +59,13 @@ If registry keys and files that are stored in excluded locations are required to A default group of settings location templates for common Microsoft applications and Windows settings is included with Windows 10, version 1607. If you customize these templates, or create settings location templates to synchronize settings for custom applications, the UE-V service can be configured to use a settings template catalog to store the templates. In this case, you'll need to include the default templates with the custom templates in the settings template catalog. ->**Important** -After you enable the UE-V service, you’ll need to register the settings location templates using the `Register-UevTemplate` cmdlet in Windows PowerShell. +> [!IMPORTANT] +> After you enable the UE-V service, you'll need to register the settings location templates using the `Register-UevTemplate` cmdlet in Windows PowerShell. When you use Group Policy to configure the settings template catalog path, you can choose to replace the default Microsoft templates. If you configure the policy settings to replace the default Microsoft templates, all of the default Microsoft templates that are installed with Windows 10, version 1607 are deleted and only the templates that are located in the settings template catalog are used. -**Note** -If there are customized templates in the settings template catalog that use the same ID as the default Microsoft templates, the Microsoft templates are ignored. +> [!NOTE] +> If there are customized templates in the settings template catalog that use the same ID as the default Microsoft templates, the Microsoft templates are ignored. You can replace the default templates by using the UE-V Windows PowerShell features. To replace the default Microsoft template with Windows PowerShell, unregister all of the default Microsoft templates, and then register the customized templates. @@ -98,14 +79,13 @@ The UE-V template generator is included in the Windows Assessment and Deployment Install the UE-V template generator on a computer that you can use to create a custom settings location template. This computer should have the applications installed for which custom settings location templates need to be generated. ->**Important** -UE-V for Windows 10, version 1607 includes a new template generator. If you are upgrading from an existing UE-V installation, you’ll need to use the new generator to create settings location templates. Templates created with previous versions of the UE-V template generator will continue to work. +> [!IMPORTANT] +> UE-V for Windows 10, version 1607 includes a new template generator. If you are upgrading from an existing UE-V installation, you'll need to use the new generator to create settings location templates. Templates created with previous versions of the UE-V template generator will continue to work. **To install the UE-V template generator** -1. Go to [Download the Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) to access the ADK. - -2. Select the **Get Windows ADK for Windows 10** button on this page to start the ADK installer. On the window pictured below, select **Microsoft User Experience Virtualization (UE-V) Template Generator** and then select Install. +1. Go to [Download the Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) to access the ADK. +1. Select the **Get Windows ADK for Windows 10** button on this page to start the ADK installer. On the window pictured below, select **Microsoft User Experience Virtualization (UE-V) Template Generator** and then select Install. -| **Component** | **Function** | -|--------------------------|------------------| -| **UE-V service** | Enabled on every device that needs to synchronize settings, the **UE-V service** monitors registered applications and Windows for any settings changes, then synchronizes those settings between devices. | -| **Settings packages** | Application settings and Windows settings are stored in **settings packages** created by the UE-V service. Settings packages are built, locally stored, and copied to the settings storage location.
The setting values for **desktop applications** are stored when the user closes the application.
Values for **Windows settings** are stored when the user logs off, when the computer is locked, or when the user disconnects remotely from a computer.
The sync provider determines when the application or operating system settings are read from the **Settings Packages** and synchronized. | -| **Settings storage location** | This is a standard network share that your users can access. The UE-V service verifies the location and creates a hidden system folder in which to store and retrieve user settings. | -| **Settings location templates** | UE-V uses XML files as settings location templates to monitor and synchronize desktop application settings and Windows desktop settings between user computers. By default, some settings location templates are included in UE-V. You can also create, edit, or validate custom settings location templates by [managing settings synchronization for custom applications](#manage-settings-synchronization-for-custom-applications).
**Note**  Settings location templates are not required for Windows applications. | -| **Universal Windows applications list** | Settings for Windows applications are captured and applied dynamically. The app developer specifies the settings that are synchronized for each app. UE-V determines which Windows applications are enabled for settings synchronization using a managed list of applications. By default, this list includes most Windows applications.
You can add or remove applications in the Windows app list by following the procedures in [Managing UE-V Settings Location Templates Using Windows PowerShell and WMI](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md). | +| **Component** | **Function** | +|--|--| +| **UE-V service** | Enabled on every device that needs to synchronize settings, the **UE-V service** monitors registered applications and Windows for any settings changes, then synchronizes those settings between devices. | +| **Settings packages** | Application settings and Windows settings are stored in **settings packages** created by the UE-V service. Settings packages are built, locally stored, and copied to the settings storage location.
The setting values for **desktop applications** are stored when the user closes the application.
Values for **Windows settings** are stored when the user logs off, when the computer is locked, or when the user disconnects remotely from a computer.
The sync provider determines when the application or operating system settings are read from the **Settings Packages** and synchronized. | +| **Settings storage location** | This is a standard network share that your users can access. The UE-V service verifies the location and creates a hidden system folder in which to store and retrieve user settings. | +| **Settings location templates** | UE-V uses XML files as settings location templates to monitor and synchronize desktop application settings and Windows desktop settings between user computers. By default, some settings location templates are included in UE-V. You can also create, edit, or validate custom settings location templates by [managing settings synchronization for custom applications](#manage-settings-synchronization-for-custom-applications).
**Note**  Settings location templates are not required for Windows applications. | +| **Universal Windows applications list** | Settings for Windows applications are captured and applied dynamically. The app developer specifies the settings that are synchronized for each app. UE-V determines which Windows applications are enabled for settings synchronization using a managed list of applications. By default, this list includes most Windows applications.
You can add or remove applications in the Windows app list by following the procedures in [Managing UE-V Settings Location Templates Using Windows PowerShell and WMI](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md). | ## Manage settings synchronization for custom applications Use these UE-V components to create and manage custom templates for your third-party or line-of-business applications. -| Component | Description | -|-------------------------------|---------------| -| **UE-V template generator** | Use the **UE-V template generator** to create custom settings location templates that you can then distribute to user computers. The UE-V template generator also lets you edit an existing template or validate a template that was created with a different XML editor.
With the Windows 10, version 1607 release, the UE-V template generator is installed with the [Windows Assessment and Deployment kit for Windows 10, version 1607](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) (Windows ADK).
If you are upgrading from an existing UE-V installation, you’ll need to use the new generator to create new settings location templates. Application templates created with previous versions of the UE-V template generator are still supported, however. | -| **Settings template catalog** | The **settings template catalog** is a folder path on UE-V computers or a Server Message Block (SMB) network share that stores the custom settings location templates. The UE-V service checks this location once a day, retrieves new or updated templates, and updates its synchronization behavior.
If you use only the UE-V default settings location templates, then a settings template catalog is unnecessary. For more information about settings deployment catalogs, see [Deploy a UE-V settings template catalog](uev-deploy-uev-for-custom-applications.md).| +| Component | Description | +|--|--| +| **UE-V template generator** | Use the **UE-V template generator** to create custom settings location templates that you can then distribute to user computers. The UE-V template generator also lets you edit an existing template or validate a template that was created with a different XML editor.
With the Windows 10, version 1607 release, the UE-V template generator is installed with the [Windows Assessment and Deployment kit for Windows 10, version 1607](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) (Windows ADK).
If you are upgrading from an existing UE-V installation, you'll need to use the new generator to create new settings location templates. Application templates created with previous versions of the UE-V template generator are still supported, however. | +| **Settings template catalog** | The **settings template catalog** is a folder path on UE-V computers or a Server Message Block (SMB) network share that stores the custom settings location templates. The UE-V service checks this location once a day, retrieves new or updated templates, and updates its synchronization behavior.
If you use only the UE-V default settings location templates, then a settings template catalog is unnecessary. For more information about settings deployment catalogs, see [Deploy a UE-V settings template catalog](uev-deploy-uev-for-custom-applications.md). | -### Planning a UE-V deployment +### Planning a UE-V deployment Review the following articles to determine which UE-V components you'll be deploying. @@ -49,11 +45,9 @@ Review the following articles to determine which UE-V components you'll be deplo If you want to synchronize settings for custom applications, you'll need to install the UE-V template generator. Use the generator to create custom settings location templates, which involve the following tasks: - Review the [settings that are synchronized automatically in a UE-V deployment](#settings-automatically-synchronized-in-a-ue-v-deployment). - - [Determine whether you need settings synchronized for other applications](#determine-whether-you-need-settings-synchronized-for-other-applications). - Review [other considerations for deploying UE-V](#other-considerations-when-preparing-a-ue-v-deployment), including high availability and capacity planning. - - [Confirm prerequisites and supported configurations for UE-V](#confirm-prerequisites-and-supported-configurations-for-ue-v) ## Decide whether to synchronize settings for custom applications @@ -67,9 +61,7 @@ Deciding if you want UE-V to synchronize settings for custom applications is an This section explains which settings are synchronized by default in UE-V, including: - Desktop applications that are synchronized by default - - Windows desktop settings that are synchronized by default - - A statement of support for Windows applications setting synchronization For downloadable UE-V templates, see: [User Experience Virtualization (UE-V) settings templates for Microsoft Office](https://www.microsoft.com/download/details.aspx?id=46367) @@ -79,17 +71,15 @@ For downloadable UE-V templates, see: [User Experience Virtualization (UE-V) set When you enable the UE-V service on user devices, it registers a default group of settings location templates that capture settings values for these common Microsoft applications. | Application category | Description | -|-----------------------------|-------------------| +|--|--| | Microsoft Office 2016 applications | Microsoft Access 2016
Microsoft Lync 2016
Microsoft Excel 2016
Microsoft OneNote 2016
Microsoft Outlook 2016
Microsoft PowerPoint 2016
Microsoft Project 2016
Microsoft Publisher 2016
Microsoft SharePoint Designer 2013 (not updated for 2016)
Microsoft Visio 2016
Microsoft Word 2016
Microsoft Office Upload Manager
Microsoft Infopath has been removed (deprecated) from the Office 2016 suite | -| Microsoft Office 2013 applications
[Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367) | Microsoft Word 2013
Microsoft Excel 2013
Microsoft Outlook 2013
Microsoft Access 2013
Microsoft Project 2013
Microsoft PowerPoint 2013
Microsoft Publisher 2013
Microsoft Visio 2013
Microsoft InfoPath 2013
Microsoft Lync 2013
Microsoft OneNote 2013
Microsoft SharePoint Designer 2013
Microsoft Office 2013 Upload Center
Microsoft OneDrive for Business 2013 -| Microsoft Office 2010 applications
[Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367) | Microsoft Word 2010
Microsoft Excel 2010
Microsoft Outlook 2010
Microsoft Access 2010
Microsoft Project 2010
Microsoft PowerPoint 2010
Microsoft Publisher 2010
Microsoft Visio 2010
Microsoft SharePoint Workspace 2010
Microsoft InfoPath 2010
Microsoft Lync 2010
Microsoft OneNote 2010
Microsoft SharePoint Designer 2010 | +| Microsoft Office 2013 applications
[Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367) | Microsoft Word 2013
Microsoft Excel 2013
Microsoft Outlook 2013
Microsoft Access 2013
Microsoft Project 2013
Microsoft PowerPoint 2013
Microsoft Publisher 2013
Microsoft Visio 2013
Microsoft InfoPath 2013
Microsoft Lync 2013
Microsoft OneNote 2013
Microsoft SharePoint Designer 2013
Microsoft Office 2013 Upload Center
Microsoft OneDrive for Business 2013 | +| Microsoft Office 2010 applications
[Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367) | Microsoft Word 2010
Microsoft Excel 2010
Microsoft Outlook 2010
Microsoft Access 2010
Microsoft Project 2010
Microsoft PowerPoint 2010
Microsoft Publisher 2010
Microsoft Visio 2010
Microsoft SharePoint Workspace 2010
Microsoft InfoPath 2010
Microsoft Lync 2010
Microsoft OneNote 2010
Microsoft SharePoint Designer 2010 | | Browser options: Internet Explorer 11 and 10 | Synchronize favorites, home page, tabs, and toolbars.
**Note**
UE-V doesn't roam settings for Internet Explorer cookies. | | Windows accessories | Microsoft NotePad, WordPad | > [!NOTE] > - An Outlook profile must be created for any device on which a user wants to sync their Outlook signature. If the profile is not already created, the user can create one and then restart Outlook on that device to enable signature synchronization. -> - > - UE-V doesn't synchronize settings between the Microsoft Calculator in Windows 10 and the Microsoft Calculator in previous operating systems. ### Windows settings synchronized by default @@ -97,22 +87,22 @@ When you enable the UE-V service on user devices, it registers a default group o UE-V includes settings location templates that capture settings values for these Windows settings. | Windows settings | Description | Apply on | Export on | Default state | -|----------------------|-----------------|--------------|---------------|-------------------| -| Desktop background | Currently active desktop background or wallpaper | Log on, unlock, remote connect, Scheduled Task events | Log off, lock, remote disconnect, or scheduled task interval | Enabled | -| Ease of Access | Accessibility and input settings, Microsoft Magnifier, Narrator, and on-Screen Keyboard | Log on only | Log off or scheduled task interval | Enabled | -| Desktop settings | Start menu and Taskbar settings, folder options, default desktop icons, more clocks, and region and language settings | Log on only | Log off or scheduled task | Enabled | +|--|--|--|--|--| +| Desktop background | Currently active desktop background or wallpaper | Log on, unlock, remote connect, Scheduled Task events | Log off, lock, remote disconnect, or scheduled task interval | Enabled | +| Ease of Access | Accessibility and input settings, Microsoft Magnifier, Narrator, and on-Screen Keyboard | Log on only | Log off or scheduled task interval | Enabled | +| Desktop settings | Start menu and Taskbar settings, folder options, default desktop icons, more clocks, and region and language settings | Log on only | Log off or scheduled task | Enabled | > [!IMPORTANT] > UE-V roams taskbar settings between Windows 10 devices. However, UE-V doesn't synchronize taskbar settings between Windows 10 devices and devices running previous operating systems versions. | Settings group | Category | Capture | Apply | -|--------------------------|----------------|----------------|--------------| -| **Application Settings** | Windows applications | Close application
Windows application settings change event | Start the UE-V App Monitor at startup
Open app
Windows application settings change event
Arrival of a settings package | -| | Desktop applications | Application closes | Application opens and closes | -| **Desktop settings** | Desktop background | Lock or log off | Log on, unlock, remote connect, notification of new package arrival, or scheduled task runs | -| | Ease of Access (Common - Accessibility, Narrator, Magnifier, On-Screen-Keyboard) | Lock or Log off | Log on | -| | Ease of Access (Shell - Audio, Accessibility, Keyboard, Mouse) | Lock or log off | Log on, unlock, remote connect, notification of new package arrival, or scheduled task runs | -| | Desktop settings | Lock or log off | Log on | +|--|--|--|--| +| **Application Settings** | Windows applications | Close application
Windows application settings change event | Start the UE-V App Monitor at startup
Open app
Windows application settings change event
Arrival of a settings package | +| | Desktop applications | Application closes | Application opens and closes | +| **Desktop settings** | Desktop background | Lock or log off | Log on, unlock, remote connect, notification of new package arrival, or scheduled task runs | +| | Ease of Access (Common - Accessibility, Narrator, Magnifier, On-Screen-Keyboard) | Lock or Log off | Log on | +| | Ease of Access (Shell - Audio, Accessibility, Keyboard, Mouse) | Lock or log off | Log on, unlock, remote connect, notification of new package arrival, or scheduled task runs | +| | Desktop settings | Lock or log off | Log on | ### UE-V-support for Windows applications @@ -130,9 +120,7 @@ Users can print to their saved network printers, including their default network Printer roaming in UE-V requires one of these scenarios: - The print server can download the required driver when it roams to a new device. - - The driver for the roaming network printer is pre-installed on any device that needs to access that network printer. - - The printer driver can be imported from Windows Update. > [!NOTE] @@ -140,16 +128,14 @@ Printer roaming in UE-V requires one of these scenarios: ### Determine whether you need settings synchronized for other applications -After you've reviewed the settings that are synchronized automatically in a UE-V deployment, you’ll need to decide whether to synchronize settings for other applications as your decision will determine how you deploy UE-V throughout your enterprise. +After you've reviewed the settings that are synchronized automatically in a UE-V deployment, you'll need to decide whether to synchronize settings for other applications as your decision will determine how you deploy UE-V throughout your enterprise. As an administrator, when you consider which desktop applications to include in your UE-V solution, consider which settings can be customized by users, and how and where the application stores its settings. Not all desktop applications have settings that can be customized or that are routinely customized by users. In addition, not all desktop applications settings can be synchronized safely across multiple devices or environments. In general, you can synchronize settings that meet the following criteria: - Settings that are stored in user-accessible locations. For example, don't synchronize settings that are stored in System32 or outside the HKEY\_CURRENT\_USER (HKCU) section of the registry. - - Settings that aren't specific to the particular device. For example, exclude network shortcuts or hardware configurations. - - Settings that can be synchronized between computers without risk of corrupted data. For example, don't use settings that are stored in a database file. ### Checklist for evaluating custom applications @@ -162,7 +148,7 @@ If you've decided that you need to synchronize settings for custom applications, | ![Checklist box.](images/uev-checklist-box.gif) | Is it important for the user that these settings are synchronized? | | ![Checklist box.](images/uev-checklist-box.gif) | Are these user settings already managed by an application management or settings policy solution? UE-V applies application settings at application startup and Windows settings at logon, unlock, or remote connect events. If you use UE-V with other settings sharing solutions, users might experience inconsistency across synchronized settings. | | ![Checklist box.](images/uev-checklist-box.gif) | Are the application settings specific to the computer? Application preferences and customizations that are associated with hardware or specific computer configurations don't consistently synchronize across sessions and can cause a poor application experience. | -| ![Checklist box.](images/uev-checklist-box.gif) | Does the application store settings in the Program Files directory or in the file directory that is located in the **Users**\\ \[User name\] \\**AppData**\\**LocalLow** directory? Application data that is stored in either of these locations usually shouldn't synchronize with the user, because this data is specific to the computer or because the data is too large to synchronize. | +| ![Checklist box.](images/uev-checklist-box.gif) | Does the application store settings in the Program Files directory or in the file directory that is located in the **Users**\ \[User name\] \**AppData**\**LocalLow** directory? Application data that is stored in either of these locations usually shouldn't synchronize with the user, because this data is specific to the computer or because the data is too large to synchronize. | | ![Checklist box.](images/uev-checklist-box.gif) | Does the application store any settings in a file that contains other application data that shouldn't synchronize? UE-V synchronizes files as a single unit. If settings are stored in files that include application data other than settings, then synchronizing this extra data can cause a poor application experience.| | ![Checklist box.](images/uev-checklist-box.gif) | How large are the files that contain the settings? The performance of the settings synchronization can be affected by large files. Including large files can affect the performance of settings synchronization. | @@ -171,20 +157,14 @@ If you've decided that you need to synchronize settings for custom applications, You should also consider these things when you're preparing to deploy UE-V: - [Managing credentials synchronization](#managing-credentials-synchronization-in-ue-v) - - [Windows applications settings synchronization](#windows-applications-settings-synchronization) - - [Custom UE-V settings location templates](#custom-ue-v-settings-location-templates) - - [Unintentional user settings configurations](#prevent-unintentional-user-settings-configuration) - - [Performance and capacity](#performance-and-capacity-planning) - - [High availability](#high-availability-for-ue-v) - - [Computer clock synchronization](#synchronize-computer-clocks-for-ue-v-settings-synchronization) -### Managing credentials synchronization in UE-V +### Managing credentials synchronization in UE-V Many enterprise applications, including Microsoft Outlook, Lync, and Skype for Business prompt users for their domain credentials when they log in. Users have the option of saving their credentials to disk to prevent having to enter them every time they open these applications. Enabling roaming credentials synchronization lets users save their credentials on one computer and avoid reentering them on every computer they use in their environment. Users can synchronize some domain credentials with UE-V. @@ -220,25 +200,19 @@ Copy [Group Policy](uev-configuring-uev-with-group-policy-objects.md)**:** You must edit the Group Policy administrative template for UE-V, which is included in Windows 10, version 1607, to enable credential synchronization through group policy. Credentials synchronization is managed in Windows settings. To manage this feature with Group Policy, enable the **Synchronize Windows** settings policy. -1. Open Group Policy Editor and navigate to **User Configuration > Administrative Templates > Windows Components > Microsoft User Experience Virtualization**. - -2. Double-click **Synchronize Windows settings**. - -3. If this policy is enabled, you can enable credentials synchronization by checking the **Roaming Credentials** check box, or disable credentials synchronization by unchecking it. - -4. Select **OK**. +1. Open Group Policy Editor and navigate to **User Configuration > Administrative Templates > Windows Components > Microsoft User Experience Virtualization**. +1. Double-click **Synchronize Windows settings**. +1. If this policy is enabled, you can enable credentials synchronization by checking the **Roaming Credentials** check box, or disable credentials synchronization by unchecking it. +1. Select **OK**. ### Credential locations synchronized by UE-V Credential files saved by applications into the following locations are synchronized: -- %UserProfile%\\AppData\\Roaming\\Microsoft\\Credentials\\ - -- %UserProfile%\\AppData\\Roaming\\Microsoft\\Crypto\\ - -- %UserProfile%\\AppData\\Roaming\\Microsoft\\Protect\\ - -- %UserProfile%\\AppData\\Roaming\\Microsoft\\SystemCertificates\\ +- %UserProfile%\AppData\Roaming\Microsoft\Credentials\ +- %UserProfile%\AppData\Roaming\Microsoft\Crypto\ +- %UserProfile%\AppData\Roaming\Microsoft\Protect\ +- %UserProfile%\AppData\Roaming\Microsoft\SystemCertificates\ Credentials saved to other locations aren't synchronized by UE-V. @@ -247,16 +221,14 @@ Credentials saved to other locations aren't synchronized by UE-V. UE-V manages Windows application settings synchronization in three ways: - **Sync Windows applications:** Allow or deny any Windows application synchronization - - **Windows applications list:** Synchronize a list of Windows applications - - **Unlisted default sync behavior:** Determine the synchronization behavior of Windows applications that aren't in the Windows applications list. For more information, see the [Windows Application List](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md#win8applist). ### Custom UE-V settings location templates -If you're deploying UE-V to synchronize settings for custom applications, you’ll use the UE-V template generator to create custom settings location templates for those desktop applications. After you create and test a custom settings location template in a test environment, you can deploy the settings location templates to user devices. +If you're deploying UE-V to synchronize settings for custom applications, you'll use the UE-V template generator to create custom settings location templates for those desktop applications. After you create and test a custom settings location template in a test environment, you can deploy the settings location templates to user devices. Custom settings location templates must be deployed with an existing deployment infrastructure, such as an enterprise software distribution method, including Microsoft Configuration Manager, with preferences, or by configuring a UE-V settings template catalog. Templates that are deployed with Configuration Manager or Group Policy must be registered using UE-V WMI or Windows PowerShell. @@ -267,13 +239,9 @@ For more information about custom settings location templates, see [Deploy UE-V UE-V downloads new user settings information from a settings storage location and applies the settings to the local device in these instances: - Each time an application is started that has a registered UE-V template - - When a user signs in to a device - - When a user unlocks a device - - When a connection is made to a remote desktop device running UE-V - - When the Sync Controller Application scheduled task is run If UE-V is installed on computer A and computer B, and the settings that you want for the application are on computer A, then computer A should open and close the application first. If the application is opened and closed on computer B first, then the application settings on computer A are configured to the application settings on computer B. Settings are synchronized between computers on per-application basis. Over time, settings become consistent between computers as they're opened and closed with preferred settings. @@ -297,20 +265,14 @@ By default, UE-V synchronization times out after 2 seconds to prevent excessive The UE-V settings storage location and settings template catalog support storing user data on any writable share. To ensure high availability, follow these criteria: - Format the storage volume with an NTFS file system. - - The share can use Distributed File System (DFS) replication, but Distributed File System Replication (DFSR) isn't supported. Distributed File System Namespaces (DFSN) are supported. For detailed information, see: - - [Deploying Roaming User Profiles](/windows-server/storage/folder-redirection/deploy-roaming-user-profiles) - - - [Information about Microsoft support policy for a DFS-R and DFS-N deployment scenario](/troubleshoot/windows-server/networking/support-policy-for-dfsr-dfsn-deployment) In addition, because SYSVOL uses DFSR for replication, SYSVOL can't be used for UE-V data file replication. - Configure the share permissions and NTFS access control lists (ACLs) as specified in [Deploying the settings storage location for UE-V](uev-deploy-required-features.md). - - Use file server clustering along with the UE-V service to provide access to copies of user state data if communications failures occur. - - You can store the settings storage path data (user data) and settings template catalog templates on clustered shares, on DFSN shares, or on both. ### Synchronize computer clocks for UE-V settings synchronization @@ -322,16 +284,14 @@ Computers that run the UE-V service must use a time server to maintain a consist Before you proceed, ensure that your environment meets these requirements for using UE-V. | Operating system | Edition | Service pack | System architecture | Windows PowerShell | Microsoft .NET Framework | -|--------------------------|---------------|------------------|-------------------------|--------------------------|--------------------------------| -| Windows 10, version 1607 | Windows 10 for Enterprise | NA | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher | -| Windows 8 and Windows 8.1 | Enterprise or Pro | None | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher | -| Windows Server 2012 and Windows Server 2012 R2 | Standard or Datacenter | None | 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher | +|--|--|--|--|--|--| +| Windows 10, version 1607 | Windows 10 for Enterprise | NA | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher | +| Windows 8 and Windows 8.1 | Enterprise or Pro | None | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher | +| Windows Server 2012 and Windows Server 2012 R2 | Standard or Datacenter | None | 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher | > [!NOTE] > - Windows Server 2012 operating systems come with .NET Framework 4.5 installed. The Windows 10 operating system comes with .NET Framework 4.6 installed. -> - -> - The “Delete Roaming Cache” policy for mandatory profiles isn't supported with UE-V and shouldn't be used. +> - The "Delete Roaming Cache" policy for mandatory profiles isn't supported with UE-V and shouldn't be used. There are no special random access memory (RAM) requirements specific to UE-V. @@ -340,11 +300,8 @@ There are no special random access memory (RAM) requirements specific to UE-V. Sync Provider is the default setting for users and synchronizes a local cache with the settings storage location in these instances: - Log on/log off - - Lock/unlock - - Remote desktop connect/disconnect - - Application open/close A scheduled task manages this synchronization of settings every 30 minutes or through trigger events for certain applications. For more information, see [Changing the frequency of UE-V scheduled tasks](uev-changing-the-frequency-of-scheduled-tasks.md). @@ -356,7 +313,6 @@ The UE-V service synchronizes user settings for devices that aren't always conne Enable this configuration using one of these methods: - After you enable the UE-V service, use the Settings Management feature in Microsoft Configuration Manager or the UE-V ADMX templates (installed with Windows 10, version 1607) to push the SyncMethod = None configuration. - - Use Windows PowerShell or Windows Management Instrumentation (WMI) to set the SyncMethod = None configuration. Restart the device to allow the settings to synchronize. @@ -364,7 +320,6 @@ Restart the device to allow the settings to synchronize. > [!NOTE] > These methods do not work for pooled virtual desktop infrastructure (VDI) environments. - > [!NOTE] > If you set *SyncMethod = None*, any settings changes are saved directly to the server. If the network connection to the settings storage path is not found, then the settings changes are cached on the device and are synchronized the next time that the sync provider runs. If the settings storage path is not found and the user profile is removed from a pooled VDI environment on log off, settings changes are lost and the user must reapply the change when the computer is reconnected to the settings storage path. @@ -383,20 +338,11 @@ Install the UE-V template generator on the device that is used to create custom The UE-V template generator must be installed on a device that uses an NTFS file system. The UE-V template generator software requires .NET Framework 4. For more information, see [Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md). - - - - ## Other resources for this feature - [User Experience Virtualization overview](uev-for-windows.md) - - [Get started with UE-V](uev-getting-started.md) - - [Upgrade to UE-V for Windows 10](uev-upgrade-uev-from-previous-releases.md) - - [Administering UE-V](uev-administering-uev.md) - - [Troubleshooting UE-V](uev-troubleshooting.md) - - [Technical Reference for UE-V](uev-technical-reference.md) diff --git a/windows/configuration/ue-v/uev-release-notes-1607.md b/windows/configuration/ue-v/uev-release-notes-1607.md index 3c62115b4f..d60863a9c7 100644 --- a/windows/configuration/ue-v/uev-release-notes-1607.md +++ b/windows/configuration/ue-v/uev-release-notes-1607.md @@ -7,7 +7,6 @@ ms.topic: article # User Experience Virtualization (UE-V) Release Notes - This topic includes information required to successfully install and use UE-V that isn't included in the User Experience Virtualization (UE-V) documentation. If there are differences between the information in this topic and other UE-V topics, the latest change should be considered authoritative. ### Company Settings Center removed in UE-V for Windows 10, version 1607 @@ -51,7 +50,7 @@ WORKAROUND: Install only one version of Office or limit which settings are synch ### Uninstallation and reinstallation of Windows 8 applications reverts settings to initial state -While UE-V settings synchronization is being used for a Windows 8 application, if the user uninstalls the application and then reinstalls the application, the application’s settings revert to their default values. This result happens because the uninstall removes the local (cached) copy of the application’s settings but doesn't remove the local UE-V settings package. When the application is reinstalled and launched, UE-V gathers the application settings that were reset to the application defaults and then uploads the default settings to the central storage location. Other computers running the application then download the default settings. This behavior is identical to the behavior of desktop applications. +While UE-V settings synchronization is being used for a Windows 8 application, if the user uninstalls the application and then reinstalls the application, the application's settings revert to their default values. This result happens because the uninstall removes the local (cached) copy of the application's settings but doesn't remove the local UE-V settings package. When the application is reinstalled and launched, UE-V gathers the application settings that were reset to the application defaults and then uploads the default settings to the central storage location. Other computers running the application then download the default settings. This behavior is identical to the behavior of desktop applications. WORKAROUND: None. @@ -92,17 +91,10 @@ WORKAROUND: None **Additional resources for this feature** - [UE-V Registry Settings](/troubleshoot/windows-client/ue-v/ue-v-registry-settings) - - [How To Enable Debug Logging in Microsoft User Experience Virtualization (UE-V)](/troubleshoot/windows-client/ue-v/enable-debug-logging) - - [User Experience Virtualization](uev-for-windows.md) - - [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) - - [Upgrade to UE-V for Windows 10](uev-upgrade-uev-from-previous-releases.md) - - [Administering UE-V](uev-administering-uev.md) - - [Troubleshooting UE-V](uev-troubleshooting.md) - - [Technical Reference for UE-V](uev-technical-reference.md) diff --git a/windows/configuration/ue-v/uev-security-considerations.md b/windows/configuration/ue-v/uev-security-considerations.md index b3b5bd6ceb..671559e15e 100644 --- a/windows/configuration/ue-v/uev-security-considerations.md +++ b/windows/configuration/ue-v/uev-security-considerations.md @@ -7,31 +7,27 @@ ms.topic: article # Security Considerations for UE-V - This topic contains a brief overview of accounts and groups, log files, and other security-related considerations for User Experience Virtualization (UE-V). For more information, follow the links that are provided here. ## Security considerations for UE-V configuration - > [!IMPORTANT] > When you create the settings storage share, limit the share access to users who require access. Because settings packages might contain personal information, you should take care to protect them as much as possible. In general, do the following steps: - Restrict the share to only those users who require access. Create a security group for users who have redirected folders on a particular share and limit access to only those users. - - When you create the share, hide the share by putting a $ after the share name. This addition hides the share from casual browsers, and the share isn't visible in My Network Places. - - Only give users the minimum number of permissions that they must have. The following tables show the required permissions. -1. Set the following share-level SMB permissions for the setting storage location folder. +1. Set the following share-level SMB permissions for the setting storage location folder. |User account|Recommended permissions| |--- |--- | |Everyone|No permissions| |Security group of UE-V|Full control| -2. Set the following NTFS file system permissions for the settings storage location folder. +1. Set the following NTFS file system permissions for the settings storage location folder. |User account|Recommended permissions|Folder| |--- |--- |--- | @@ -40,7 +36,7 @@ Because settings packages might contain personal information, you should take ca |Security group of UE-V users|List folder/read data, create folders/append data|This folder only| |Everyone|Remove all permissions|No permissions| -3. Set the following share-level SMB permissions for the settings template catalog folder. +1. Set the following share-level SMB permissions for the settings template catalog folder. |User account|Recommend permissions| |--- |--- | @@ -48,7 +44,7 @@ Because settings packages might contain personal information, you should take ca |Domain computers|Read permission Levels| |Administrators|Read/write permission levels| -4. Set the following NTFS permissions for the settings template catalog folder. +1. Set the following NTFS permissions for the settings template catalog folder. |User account|Recommended permissions|Apply to| |--- |--- |--- | @@ -69,11 +65,9 @@ As of Windows Server 2003, several features of the Windows Server operating syst - **IPsec** - The IP Security Protocol (IPsec) provides network-level authentication, data integrity, and encryption. IPsec ensures that: - - Roamed data is safe from data modification while data is en route. - - - Roamed data is safe from interception, viewing, or copying. - - - Roamed data is safe from access by unauthenticated parties. + - Roamed data is safe from data modification while data is en route. + - Roamed data is safe from interception, viewing, or copying. + - Roamed data is safe from access by unauthenticated parties. - **SMB Signing** - The Server Message Block (SMB) authentication protocol supports message authentication, which prevents active message and "man-in-the-middle" attacks. SMB signing provides this authentication by placing a digital signature into each SMB. The digital signature is then verified by both the client and the server. In order to use SMB signing, you must first either enable it, or you must require it on both the SMB client and the SMB server. The SMB signing imposes a performance penalty. It doesn't consume any more network bandwidth, but it uses more CPU cycles on the client and server side. @@ -96,20 +90,18 @@ This permission configuration enables users to create folders for settings stora > [!NOTE] > Additional security can be configured when a Windows Server is used for the settings storage share. UE-V can be configured to verify that either the local Administrators group or the current user is the owner of the folder where settings packages are stored. To enable additional security, use the following command: -1. Add the REG\_DWORD registry key RepositoryOwnerCheckEnabled to `HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration`. - -2. Set the registry key value to *1*. +1. Add the REG\_DWORD registry key RepositoryOwnerCheckEnabled to `HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration`. +1. Set the registry key value to *1*. When this configuration setting is in place, the UE-V service verifies that the local Administrators group or current user is the owner of the settings package folder. If not, then the UE-V service doesn't grant access to the folder. - If you must create folders for the users, ensure that you have the correct permissions set. We strongly recommend that you don't pre-create folders. Instead, let the UE-V service create the folder for the user. ### Ensure correct permissions to store UE-V 2 settings in a home directory or custom directory -If you redirect UE-V settings to a user’s home directory or a custom Active Directory (AD) directory, ensure that the permissions on the directory are set appropriately for your organization. +If you redirect UE-V settings to a user's home directory or a custom Active Directory (AD) directory, ensure that the permissions on the directory are set appropriately for your organization. ### Review the contents of settings location templates and control access to them as needed @@ -118,7 +110,6 @@ When a settings location template is being created, the UE-V generator uses a Li If you plan to share settings location templates with anyone outside your organization, you should review all the settings locations and ensure the settings location templates don't contain any personal or company information. You can view the contents by opening the settings location template files using any XML viewer. The following are ways you can view and remove any personal or company information from the settings location template files before sharing with anyone outside your company: - **Template Author Name** - Specify a general, non-identifying name for the template author name or exclude this data from the template. - - **Template Author Email** - Specify a general, non-identifying template author email or exclude this data from the template. To remove the template author name or template author email, you can use the UE-V generator application. From the generator, select **Edit a Settings Location Template**. Select the settings location template to edit from the recently used templates or Browse to the settings template file. Select **Next** to continue. On the Properties page, remove the data from the Template author name or Template author email text fields. Save the settings location template. diff --git a/windows/configuration/ue-v/uev-sync-trigger-events.md b/windows/configuration/ue-v/uev-sync-trigger-events.md index f4eacc061c..706636f572 100644 --- a/windows/configuration/ue-v/uev-sync-trigger-events.md +++ b/windows/configuration/ue-v/uev-sync-trigger-events.md @@ -7,7 +7,6 @@ ms.topic: article # Sync Trigger Events for UE-V - User Experience Virtualization (UE-V) lets you synchronize your application and Windows settings across all your domain-joined devices. *Sync trigger events* define when the UE-V service synchronizes those settings with the settings storage location. For more information about Sync Method configuration, see [Sync Methods for UE-V](uev-sync-methods.md). ## UE-V Sync Trigger Events @@ -27,18 +26,6 @@ The following table explains the trigger events for classic applications and Win ## Related topics - [Technical Reference for UE-V](uev-technical-reference.md) - [Changing the Frequency of UE-V Scheduled Tasks](uev-changing-the-frequency-of-scheduled-tasks.md) - [Choose the Configuration Method for UE-V](uev-deploy-required-features.md) - - - - - - - - - diff --git a/windows/configuration/ue-v/uev-synchronizing-microsoft-office-with-uev.md b/windows/configuration/ue-v/uev-synchronizing-microsoft-office-with-uev.md index 776c0564c8..052908cc95 100644 --- a/windows/configuration/ue-v/uev-synchronizing-microsoft-office-with-uev.md +++ b/windows/configuration/ue-v/uev-synchronizing-microsoft-office-with-uev.md @@ -7,7 +7,6 @@ ms.topic: article # Synchronizing Office with UE-V - Microsoft User Experience Virtualization (UE-V) supports the synchronization of Microsoft Office application settings. The combination of UE-V and App-V support for Office enables the same experience on virtualized instances of Office from any UE-V-enabled device or virtualized desktop. To synchronize Office applications settings, you can download Office templates from the [User Experience Virtualization (UE-V) Template Gallery](https://gallery.technet.microsoft.com/site/search?f%5B0%5D.Type=RootCategory&f%5B0%5D.Value=UE-V&f%5B0%5D.Text=UE-V). This resource provides Microsoft-authored UE-V settings location templates and community-developed settings location templates. @@ -16,11 +15,10 @@ To synchronize Office applications settings, you can download Office templates f UE-V includes settings location templates for Microsoft Office 2016, 2013, and 2010. In previous versions of UE-V, settings location templates for Office 2013 and Office 2010 were distributed and registered when you installed the UE-V agent. Now that UE-V is a feature in Windows 10, version 1607, settings location templates are installed when you install or upgrade to the new operating system. -These templates help synchronize users’ Office experience between devices. Microsoft Office 2016 settings roamed by Office 365 experience aren't included in these settings. For a list of Office 365-specific settings, see [Overview of user and roaming settings for Office](/previous-versions/office/office-2013-resource-kit/jj733593(v=office.15)). +These templates help synchronize users' Office experience between devices. Microsoft Office 2016 settings roamed by Office 365 experience aren't included in these settings. For a list of Office 365-specific settings, see [Overview of user and roaming settings for Office](/previous-versions/office/office-2013-resource-kit/jj733593(v=office.15)). ## Synchronized Office Settings - Review the following tables for details about Office support in UE-V: ### Supported UE-V templates for Microsoft Office @@ -40,13 +38,10 @@ Review the following tables for details about Office support in UE-V: You can deploy UE-V settings location template with the following methods: - **Registering template with PowerShell**. If you use Windows PowerShell to manage computers, run the following Windows PowerShell command as Administrator to register this settings location template: - ```powershell Register-UevTemplate -Path ``` For more information about using UE-V and Windows PowerShell, see [Managing UE-V settings location templates using Windows PowerShell and WMI](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md). - - **Registering template with Template Catalog Path**. If you use the Settings Template Catalog Path to manage templates on users' computers, copy the Office template into the folder defined in the UE-V service. The next time the Template Auto Update (ApplySettingsCatalog.exe) scheduled task runs, the settings location template will be registered on the device. For more information, see [Deploy a settings template catalog](uev-deploy-uev-for-custom-applications.md). - - **Registering template with Configuration Manager**. If you use Configuration Manager to manage your UE-V settings storage templates, recreate the Template Baseline CAB, import it into Configuration Manager, and then deploy the baseline to user devices. diff --git a/windows/configuration/ue-v/uev-technical-reference.md b/windows/configuration/ue-v/uev-technical-reference.md index 80ca92f754..0e79394849 100644 --- a/windows/configuration/ue-v/uev-technical-reference.md +++ b/windows/configuration/ue-v/uev-technical-reference.md @@ -7,55 +7,25 @@ ms.topic: article # Technical Reference for UE-V - This technical reference section includes additional technical documentation about the various features of User Experience Virtualization (UE-V). This information is provided to help the administrator better understand UE-V. ## Technical reference topics for UE-V - - [Sync Methods for UE-V](uev-sync-methods.md) - Defines how UE-V synchronizes settings between computers and the settings storage location. Sync Provider is the default sync method for UE-V. This topic includes technical reference information for sync methods, including the Sync Provider. - - [Sync Trigger Events for UE-V](uev-sync-trigger-events.md) - Defines when the UE-V service synchronizes those settings with the settings storage location. This topic provides technical reference information about when synchronization takes place based upon the sync method deployed. - - [Synchronizing Microsoft Office with UE-V](uev-synchronizing-microsoft-office-with-uev.md) - Provides guidance for downloading and enabling the Microsoft-authored UE-V settings location templates that support Microsoft Office settings synchronization. - - [Application Template Schema Reference for UE-V](uev-application-template-schema-reference.md) - Details the XML structure of UE-V settings location templates and provides guidance for editing these files. - - [Security Considerations for UE-V](uev-security-considerations.md) - Provides a brief overview of accounts, groups, and other security-related considerations for UE-V. ## Other resources for this feature - - [User Experience Virtualization overview](uev-for-windows.md) - - [Get Started with UE-V](uev-getting-started.md) - - [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) - - [Administering UE-V](uev-administering-uev.md) - - [Troubleshooting UE-V](uev-troubleshooting.md) - - - - - - - - - - - - - - diff --git a/windows/configuration/ue-v/uev-troubleshooting.md b/windows/configuration/ue-v/uev-troubleshooting.md index 87e74c4bd2..fc72755ce6 100644 --- a/windows/configuration/ue-v/uev-troubleshooting.md +++ b/windows/configuration/ue-v/uev-troubleshooting.md @@ -7,30 +7,16 @@ ms.topic: article # Troubleshooting UE-V - - For information that can help with troubleshooting UE-V for Windows 10, see: - - [UE-V FAQ Wiki](https://social.technet.microsoft.com/wiki/contents/articles/35333.ue-v-important-changes-in-ue-v-functionality-after-the-windows-10-anniversary-update.aspx) - - [UE-V: List of Microsoft Support Knowledge Base Articles](https://social.technet.microsoft.com/wiki/contents/articles/14271.ue-v-list-of-microsoft-support-knowledge-base-articles.aspx) - - [User Experience Virtualization Release Notes](uev-release-notes-1607.md) - - [Technical Reference for UE-V](uev-technical-reference.md) - - [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc) ## Other resources - [User Experience Virtualization overview](uev-for-windows.md) - - [Get Started with UE-V](uev-getting-started.md) - - [Prepare a UE-V deployment](uev-prepare-for-deployment.md) - - [Administering UE-V](uev-administering-uev.md) - - - - diff --git a/windows/configuration/ue-v/uev-upgrade-uev-from-previous-releases.md b/windows/configuration/ue-v/uev-upgrade-uev-from-previous-releases.md index 35a73ce509..1a7730f599 100644 --- a/windows/configuration/ue-v/uev-upgrade-uev-from-previous-releases.md +++ b/windows/configuration/ue-v/uev-upgrade-uev-from-previous-releases.md @@ -7,48 +7,39 @@ ms.topic: article # Upgrade to UE-V for Windows 10 +If you're already using UE-V 2.x and you're planning to upgrade user devices to Windows 10, version 1607 or later releases, you need to make only a few adjustments to your existing environment. These steps are explained in more detail below. -If you’re already using UE-V 2.x and you’re planning to upgrade user devices to Windows 10, version 1607 or later releases, you need to make only a few adjustments to your existing environment. These steps are explained in more detail below. - -1. Upgrade user devices to Windows 10, version 1607 or later release. - -2. Verify that UE-V settings were migrated correctly. - -3. Set the template storage path to your current template store. - -4. Enable the UE-V service on user devices. - -5. Install the UE-V template generator if you want to synchronize application settings for custom applications. +1. Upgrade user devices to Windows 10, version 1607 or later release. +1. Verify that UE-V settings were migrated correctly. +1. Set the template storage path to your current template store. +1. Enable the UE-V service on user devices. +1. Install the UE-V template generator if you want to synchronize application settings for custom applications. > [!IMPORTANT] -> You can upgrade your existing UE-V installation to Windows 10, version 1607 from UE-V versions 2.1 or 2.0 only. If you are using a previous version of UE-V, you’ll need to upgrade from that version to UE-V 2.x before you upgrade to Windows 10, version 1607. +> You can upgrade your existing UE-V installation to Windows 10, version 1607 from UE-V versions 2.1 or 2.0 only. If you are using a previous version of UE-V, you'll need to upgrade from that version to UE-V 2.x before you upgrade to Windows 10, version 1607. ## Upgrade user devices to Windows 10, version 1607 -Performing an in-place upgrade on user devices automatically installs the UE-V service, updates the settings location path, and migrates users' UE-V settings. See the [Windows 10 documentation for IT Pros](/windows/deployment/) for information about upgrading user devices to Windows 10. +Performing an in-place upgrade on user devices automatically installs the UE-V service, updates the settings location path, and migrates users' UE-V settings. See the [Windows 10 documentation for IT Pros](/windows/deployment/) for information about upgrading user devices to Windows 10. -## Verify that UE-V settings were migrated correctly +## Verify that UE-V settings were migrated correctly -After upgrading a user device to Windows 10, version 1607, it’s important to verify that UE-V settings and template registrations were migrated correctly during the upgrade. You can verify UE-V settings using Windows PowerShell or the device’s registry. +After upgrading a user device to Windows 10, version 1607, it's important to verify that UE-V settings and template registrations were migrated correctly during the upgrade. You can verify UE-V settings using Windows PowerShell or the device's registry. **To verify UE-V settings using Windows PowerShell** 1. Run PowerShell as Administrator, type **Get-UEVConfiguration**, and press ENTER to view current configurations. - -2. Check that the settings were successfully updated. - -3. Type **Get-UEVTemplate** and press ENTER to check that your templates are still registered. +1. Check that the settings were successfully updated. +1. Type **Get-UEVTemplate** and press ENTER to check that your templates are still registered. > [!NOTE] - > You’ll need to register the NotePad template again after you upgrade the device to Windows 10. + > You'll need to register the NotePad template again after you upgrade the device to Windows 10. -**To verify UE-V settings using the device’s registry** +**To verify UE-V settings using the device's registry** 1. In a command prompt, run **Regedit** as Administrator. - -2. Navigate to **HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration.** - -3. Verify that the settings storage path and the settings template catalog path are pointing to the same locations as before you upgraded the device to Windows 10. +1. Navigate to **HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration.** +1. Verify that the settings storage path and the settings template catalog path are pointing to the same locations as before you upgraded the device to Windows 10. ## Set the template storage path to your current template store @@ -65,49 +56,31 @@ With Windows 10, version 1607 and later, the UE-V service replaces the UE-V Agen **To enable the UE-V service with Group Policy** -1. Open the device’s **Group Policy Editor**. - -2. Navigate to **Computer Configuration > Administrative Templates > Windows Components > Microsoft User Experience Virtualization**. - -3. Run **Enable UEV** - -4. Restart the device. +1. Open the device's **Group Policy Editor** +1. Navigate to **Computer Configuration > Administrative Templates > Windows Components > Microsoft User Experience Virtualization** +1. Run **Enable UEV** +1. Restart the device **To enable the UE-V service with Windows PowerShell** -1. Run PowerShell as Administrator, type **Enable-UEV**, and press ENTER. - -2. Restart the device. - -3. Type **Get-UEVStatus** and press ENTER to verify that the service was successfully enabled. +1. Run PowerShell as Administrator, type **Enable-UEV**, and press ENTER +1. Restart the device +1. Type **Get-UEVStatus** and press ENTER to verify that the service was successfully enabled ## Install the UE-V template generator -The UE-V template generator is included in the Windows Assessment and Deployment Kit (ADK) for Windows 10. +The UE-V template generator is included in the Windows Assessment and Deployment Kit (ADK) for Windows 10. **To install the UE-V template generator** -1. Go to [Download the Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) to access the ADK. - -2. Select the **Get Windows ADK for Windows 10** button on this page to start the ADK installer. On the screen pictured below, select **Microsoft User Experience Virtualization (UE-V) Template Generator** and then select **Install**. - +1. Select the **Get Windows ADK for Windows 10** button on this page to start the ADK installer. On the screen pictured below, select **Microsoft User Experience Virtualization (UE-V) Template Generator** and then select **Install** ![Selecting UE-V features in ADK.](images/uev-adk-select-uev-feature.png) - - -3. To open the generator, open the **Start** menu and navigate to **Windows Kits** > **Microsoft User Experience Virtualization (UE-V) Template Generator**. - - - - +1. To open the generator, open the **Start** menu and navigate to **Windows Kits** > **Microsoft User Experience Virtualization (UE-V) Template Generator** ## Other resources for this feature - [UE-V Release Notes](uev-release-notes-1607.md) - - [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) - - [Administer UE-V](uev-administering-uev.md) - - [Migrating settings packages](uev-migrating-settings-packages.md) - - [Technical Reference for UE-V](uev-technical-reference.md) diff --git a/windows/configuration/ue-v/uev-using-uev-with-application-virtualization-applications.md b/windows/configuration/ue-v/uev-using-uev-with-application-virtualization-applications.md index 1d41ca5415..ebe6fe93a6 100644 --- a/windows/configuration/ue-v/uev-using-uev-with-application-virtualization-applications.md +++ b/windows/configuration/ue-v/uev-using-uev-with-application-virtualization-applications.md @@ -5,10 +5,8 @@ ms.date: 04/19/2017 ms.topic: article --- - # Using UE-V with Application Virtualization applications - User Experience Virtualization (UE-V) supports Microsoft Application Virtualization (App-V) applications without any required modifications to either the App-V package or the UE-V template. However, another step is required because you can't run the UE-V template generator directly on a virtualized App-V application. Instead, you must install the application locally, generate the template, and then apply the template to the virtualized application. UE-V supports App-V for Windows 10 packages and App-V 5.0 packages. ## UE-V settings synchronization for App-V applications @@ -17,16 +15,15 @@ UE-V monitors when an application opens by the program name and, optionally, by **To implement settings synchronization for a virtualized application** -1. Run the UE-V template generator to collect the settings of the locally installed application whose settings you want to synchronize between computers. This process creates a settings location template. If you use a built-in template such as a Microsoft Office template, skip this step. For more information about using the UE-V template generator, see [Deploy UE-V for custom applications](uev-deploy-uev-for-custom-applications.md). +1. Run the UE-V template generator to collect the settings of the locally installed application whose settings you want to synchronize between computers. This process creates a settings location template. If you use a built-in template such as a Microsoft Office template, skip this step. For more information about using the UE-V template generator, see [Deploy UE-V for custom applications](uev-deploy-uev-for-custom-applications.md). +1. Install the App-V application package if you haven't already done so. -2. Install the App-V application package if you haven't already done so. - -3. Publish the template to the location of your settings template catalog or manually install the template by using the `Register-UEVTemplate` Windows PowerShell cmdlet. +1. Publish the template to the location of your settings template catalog or manually install the template by using the `Register-UEVTemplate` Windows PowerShell cmdlet. > [!NOTE] > If you publish the newly created template to the settings template catalog, the client does not receive the template until the sync provider updates the settings. To manually start this process, open **Task Scheduler**, expand **Task Scheduler Library**, expand **Microsoft**, and expand **UE-V**. In the results pane, right-click **Template Auto Update**, and then click **Run**. -4. Start the App-V package. +1. Start the App-V package. ## Related topics diff --git a/windows/configuration/ue-v/uev-whats-new-in-uev-for-windows.md b/windows/configuration/ue-v/uev-whats-new-in-uev-for-windows.md index ed8542b6b3..38eff11156 100644 --- a/windows/configuration/ue-v/uev-whats-new-in-uev-for-windows.md +++ b/windows/configuration/ue-v/uev-whats-new-in-uev-for-windows.md @@ -7,7 +7,6 @@ ms.topic: article # What's new in UE-V - User Experience Virtualization (UE-V) for Windows 10, version 1607, includes these new features and capabilities compared to UE-V 2.1. For more information about the UE-V for Windows 10, version 1607 release, see [UE-V Release notes](uev-release-notes-1607.md). ## UE-V is a feature in Windows 10 @@ -17,16 +16,14 @@ With Windows 10, version 1607 and later releases, UE-V is included with Windows The changes in UE-V for Windows 10, version 1607 impact already existing implementations of UE-V in the following ways: - The UE-V Agent is replaced by the UE-V service. The UE-V service is installed with Windows 10, version 1607 and no longer has to be deployed separately. Performing an in-place upgrade to Windows 10, version 1607, on user devices automatically installs the UE-V service, migrates users' UE-V configurations, and updates the settings storage path. - - The UE-V template generator is available from the Windows 10 ADK. In previous releases of UE-V, the template generator was included in the Microsoft Desktop Optimization Pack. Although you'll need to use the new template generator to create new settings location templates, existing settings location templates will continue to work. - - The Company Settings Center was removed and is no longer available on user devices. Users can no longer manage their synchronized settings. - - The inbox templates such as Office 2016 and IE 10 are included as a part of Windows 10 and need to be manually registered with Powershell or Group policy before use. For more information about how to configure an existing UE-V installation after upgrading user devices to Windows 10, see [Upgrade to UE-V for Windows 10](uev-upgrade-uev-from-previous-releases.md). -> **Important**  You can upgrade your existing UE-V installation to Windows 10 from UE-V versions 2.1 or 2.0 only. If you are using a previous version of UE-V, you'll need to upgrade from that version to UE-V 2.x before you upgrade to Windows 10. +> [!IMPORTANT] +> You can upgrade your existing UE-V installation to Windows 10 from UE-V versions 2.1 or 2.0 only. If you are using a previous version of UE-V, you'll need to upgrade from that version to UE-V 2.x before you upgrade to Windows 10. ## New UE-V template generator is available from the Windows 10 ADK @@ -56,7 +53,6 @@ In hybrid cloud environments, UE-V can roam Win32 applications on-premises while To configure UE-V to roam Windows desktop and application data only, change the following group policies: - Disable "Roam Windows settings" group policy - - Enable "Do not synchronize Windows Apps" group policy For more information about using UE-V with Enterprise State Roaming, see [Settings and data roaming FAQ](/azure/active-directory/devices/enterprise-state-roaming-faqs#what-are-the-roaming-settings-options-for-existing-windows-desktop-applications-). @@ -64,10 +60,8 @@ For more information about using UE-V with Enterprise State Roaming, see [Settin Additionally, to enable Windows 10 and UE-V to work together, configure these policy settings in the Microsoft User Experience Virtualization node: - Enable "Do Not Synchronize Windows Apps" - - Disable "Sync Windows Settings" - ## Settings Synchronization Behavior Changed in UE-V for Windows 10 While earlier versions of UE-V roamed taskbar settings between Windows 10 devices, UE-V for Windows 10, version 1607 doesn't synchronize taskbar settings between devices running Windows 10 and devices running previous versions of Windows. @@ -86,19 +80,17 @@ Users can now print to their saved network printers from any network device, inc Printer roaming in UE-V requires one of these scenarios: - The print server can download the required driver when it roams to a new device. - - The driver for the roaming network printer is pre-installed on any device that needs to access that network printer. - - The printer driver can be imported from Windows Update. -> [!Note] +> [!NOTE] > The UE-V printer roaming feature doesn't roam printer settings or preferences, such as printing double-sided. ## Office 2016 Settings Location Template UE-V for Windows 10, version 1607 includes the Microsoft Office 2016 settings location template with improved Outlook signature support. We've added synchronization of default signature settings for new, reply, and forwarded emails. Users no longer have to choose the default signature settings. -> [!Note] +> [!NOTE] > An Outlook profile must be created on any device on which a user wants to synchronize their Outlook signature. If the profile is not already created, the user can create one and then restart Outlook on that device to enable signature synchronization. UE-V works with Office 365 to determine whether Office 2016 settings are roamed by Office 365. If settings are roamed by Office 365, they aren't roamed by UE-V. For more information, see [Overview of user and roaming settings for Microsoft Office](/previous-versions/office/office-2013-resource-kit/jj733593(v=office.15)). @@ -106,7 +98,6 @@ UE-V works with Office 365 to determine whether Office 2016 settings are roamed To enable settings synchronization using UE-V, do one of the following steps: - Use Group Policy to disable Office 365 synchronization - - Don't enable the Office 365 synchronization experience during Office 2013 installation UE-V includes Office 2016, Office 2013, and Office 2010 templates. @@ -114,11 +105,7 @@ UE-V includes Office 2016, Office 2013, and Office 2010 templates. ## Related topics - [Microsoft User Experience Virtualization](uev-for-windows.md) - - [Get Started with UE-V](uev-getting-started.md) - - [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) - - [User Experience Virtualization (UE-V) Release Notes](uev-release-notes-1607.md) for Windows 10, version 1607 - - [Upgrade to UE-V for Windows 10](uev-upgrade-uev-from-previous-releases.md) diff --git a/windows/configuration/ue-v/uev-working-with-custom-templates-and-the-uev-generator.md b/windows/configuration/ue-v/uev-working-with-custom-templates-and-the-uev-generator.md index c9f7cf83b1..d043f51540 100644 --- a/windows/configuration/ue-v/uev-working-with-custom-templates-and-the-uev-generator.md +++ b/windows/configuration/ue-v/uev-working-with-custom-templates-and-the-uev-generator.md @@ -5,12 +5,8 @@ ms.date: 04/19/2017 ms.topic: article --- - # Working with custom UE-V templates and the UE-V template generator -**Applies to** -- Windows 10 - User Experience Virtualization (UE-V) uses XML files called ***settings location templates*** to monitor and synchronize application settings and Windows settings between user devices. By default, some settings location templates are included in UE-V. However, if you want to synchronize settings for desktop applications other than those settings included in the default templates, you can create your own custom settings location templates with the UE-V template generator. You can also edit or validate custom settings location templates with the UE-V template generator. Use the UE-V template generator to monitor, discover, and capture the locations where Win32 applications store settings. The template generator doesn't create settings location templates for the following types of applications: @@ -28,22 +24,16 @@ Discovered settings are grouped into two categories: **Standard** and **Non-stan The UE-V template generator opens the application as part of the discovery process. The generator can capture settings in the following locations: -- **Registry Settings** - Registry locations under **HKEY\_CURRENT\_USER** - -- **Application Settings Files** - Files that are stored under \\ **Users** \\ \[User name\] \\ **AppData** \\ **Roaming** +- **Registry Settings** - Registry locations under **HKEY_CURRENT_USER** +- **Application Settings Files** - Files that are stored under \ **Users** \ [User name] \ **AppData** \ **Roaming** The UE-V template generator excludes locations, which commonly store application software files, but don't synchronize well between user computers or environments. The UE-V template generator excludes these locations. Excluded locations are as follows: -- HKEY\_CURRENT\_USER registry keys and files to which the logged-on user can't write values - -- HKEY\_CURRENT\_USER registry keys and files that are associated with the core functionality of the Windows operating system - -- All registry keys that are located in the HKEY\_LOCAL\_MACHINE hive, which requires administrator rights and might require to set a User Account Control (UAC) agreement - +- HKEY_CURRENT_USER registry keys and files to which the logged-on user can't write values +- HKEY_CURRENT_USER registry keys and files that are associated with the core functionality of the Windows operating system +- All registry keys that are located in the HKEY_LOCAL_MACHINE hive, which requires administrator rights and might require to set a User Account Control (UAC) agreement - Files that are located in Program Files directories, which requires administrator rights and might require to set a UAC agreement - -- Files that are located under Users \\ \[User name\] \\ AppData \\ LocalLow - +- Files that are located under Users \ [User name] \ AppData \ LocalLow - Windows operating system files that are located in %Systemroot%, which requires administrator rights and might require to set a UAC agreement If registry keys and files that are stored in these locations are required to synchronize application settings, you can manually add the excluded locations to the settings location template during the template creation process. @@ -54,13 +44,10 @@ Use the UE-V template generator to edit settings location templates. When the re ### To edit a UE-V settings location template with the UE-V template generator -1. Open the **Start** menu and navigate to **Windows Kits** > **Microsoft User Experience Virtualization (UE-V) Template Generator** to open the template generator. - -2. Click **Edit a settings location template**. - -3. In the list of recently used templates, select the template to be edited. Alternatively, click **Browse** to search for the settings template file. Click **Next** to continue. - -4. Review the **Properties**, **Registry** locations, and **Files** locations for the settings template. Edit as required. +1. Open the **Start** menu and navigate to **Windows Kits** > **Microsoft User Experience Virtualization (UE-V) Template Generator** to open the template generator. +1. Click **Edit a settings location template**. +1. In the list of recently used templates, select the template to be edited. Alternatively, click **Browse** to search for the settings template file. Click **Next** to continue. +1. Review the **Properties**, **Registry** locations, and **Files** locations for the settings template. Edit as required. - On the **Properties** tab, you can view and edit the following properties: @@ -80,31 +67,22 @@ Use the UE-V template generator to edit settings location templates. When the re - The **Files** tab lists the file path and file mask of the file locations that are included in the settings location template. You can edit the file locations by using the **Tasks** drop-down menu. In the **Tasks** menu for file locations, you can add new files or folder locations, edit the scope of existing files or folders, delete files or folders, and open the selected location in Windows Explorer. To include all files in the specified folder, leave the file mask empty. -5. Click **Save** to save the changes to the settings location template. - -6. Click **Close** to close the Settings Template Wizard. Exit the UE-V template generator application. +1. Click **Save** to save the changes to the settings location template. +1. Click **Close** to close the Settings Template Wizard. Exit the UE-V template generator application. After you edit the settings location template for an application, you should test the template. Deploy the revised settings location template in a lab environment before you put it into production in the enterprise. ### How to manually edit a settings location template -1. Create a local copy of the settings location template .xml file. UE-V settings location templates are .xml files that identify the locations where application store settings values. - +1. Create a local copy of the settings location template .xml file. UE-V settings location templates are .xml files that identify the locations where application store settings values. > [!NOTE] > A settings location template is unique because of the template **ID**. If you copy the template and rename the .xml file, template registration fails because UE-V reads the template **ID** tag in the .xml file to determine the name, not the file name of the .xml file. UE-V also reads the **Version** number to know if anything has changed. If the version number is higher, UE-V updates the template. - - -2. Open the settings location template file with an XML editor. - -3. Edit the settings location template file. All changes must conform to the UE-V schema file that is defined in [SettingsLocationTempate.xsd](uev-application-template-schema-reference.md). By default, a copy of the .xsd file is located in \\ProgramData\\Microsoft\\UEV\\Templates. - -4. Increment the **Version** number for the settings location template. - -5. Save the settings location template file, and then close the XML editor. - -6. Validate the modified settings location template file by using the UE-V template generator. - -7. You must register the edited UE-V settings location template before it can synchronize settings between client computers. To register a template, open Windows PowerShell, and then run the following cmdlet: `update-uevtemplate [templatefilename]`. You can then copy the file to the settings storage catalog. The UE-V Agent on users' computers should then update as scheduled in the scheduled task. +1. Open the settings location template file with an XML editor. +1. Edit the settings location template file. All changes must conform to the UE-V schema file that is defined in [SettingsLocationTempate.xsd](uev-application-template-schema-reference.md). By default, a copy of the .xsd file is located in \ProgramData\Microsoft\UEV\Templates. +1. Increment the **Version** number for the settings location template. +1. Save the settings location template file, and then close the XML editor. +1. Validate the modified settings location template file by using the UE-V template generator. +1. You must register the edited UE-V settings location template before it can synchronize settings between client computers. To register a template, open Windows PowerShell, and then run the following cmdlet: `update-uevtemplate [templatefilename]`. You can then copy the file to the settings storage catalog. The UE-V Agent on users' computers should then update as scheduled in the scheduled task. ## Validate settings location templates with the UE-V template generator @@ -112,15 +90,11 @@ It's possible to create or edit settings location templates in an XML editor wit To validate a UE-V settings location template with the UE-V template generator: -1. Open the **Start** menu and navigate to **Windows Kits** > **Microsoft User Experience Virtualization (UE-V) Template Generator** to open the template generator. - -2. Click **Validate a settings location template**. - -3. In the list of recently used templates, select the template to be edited. Alternatively, you can **Browse** to the settings template file. Click **Next** to continue. - -4. Click **Validate** to continue. - -5. Click **Close** to close the Settings Template Wizard. Exit the UE-V template generator application. +1. Open the **Start** menu and navigate to **Windows Kits** > **Microsoft User Experience Virtualization (UE-V) Template Generator** to open the template generator. +1. Click **Validate a settings location template**. +1. In the list of recently used templates, select the template to be edited. Alternatively, you can **Browse** to the settings template file. Click **Next** to continue. +1. Click **Validate** to continue. +1. Click **Close** to close the Settings Template Wizard. Exit the UE-V template generator application. After you validate the settings location template for an application, you should test the template. Deploy the template in a lab environment before you put it into a production environment in enterprise. @@ -133,14 +107,11 @@ The [User Experience Virtualization Template Gallery](https://gallery.technet.mi Before you share a settings location template on the UE-V template gallery, ensure it doesn't contain any personal or company information. You can use any XML viewer to open and view the contents of a settings location template file. The following template values should be reviewed before you share a template with anyone outside your company. - Template Author Name - Specify a general, non-identifying name for the template author name or exclude this data from the template. - - Template Author Email - Specify a general, non-identifying template author email or exclude this data from the template. Before you deploy any settings location template that you've downloaded from the UE-V gallery, you should first test the template to ensure that the application settings synchronize settings correctly in a test environment. - ## Related topics [Administering UE-V](uev-administering-uev.md) - [Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md) diff --git a/windows/configuration/wcd/toc.yml b/windows/configuration/wcd/toc.yml new file mode 100644 index 0000000000..6ccbe0c362 --- /dev/null +++ b/windows/configuration/wcd/toc.yml @@ -0,0 +1,111 @@ +items: +- name: Windows Configuration Designer provisioning settings (reference) + href: wcd.md +- name: Changes to settings in Windows Configuration Designer + href: wcd-changes.md +- name: AccountManagement + href: wcd-accountmanagement.md +- name: Accounts + href: wcd-accounts.md +- name: ADMXIngestion + href: wcd-admxingestion.md +- name: AssignedAccess + href: wcd-assignedaccess.md +- name: Browser + href: wcd-browser.md +- name: CellCore + href: wcd-cellcore.md +- name: Cellular + href: wcd-cellular.md +- name: Certificates + href: wcd-certificates.md +- name: CleanPC + href: wcd-cleanpc.md +- name: Connections + href: wcd-connections.md +- name: ConnectivityProfiles + href: wcd-connectivityprofiles.md +- name: CountryAndRegion + href: wcd-countryandregion.md +- name: DesktopBackgroundAndColors + href: wcd-desktopbackgroundandcolors.md +- name: DeveloperSetup + href: wcd-developersetup.md +- name: DeviceFormFactor + href: wcd-deviceformfactor.md +- name: DeviceManagement + href: wcd-devicemanagement.md +- name: DeviceUpdateCenter + href: wcd-deviceupdatecenter.md +- name: DMClient + href: wcd-dmclient.md +- name: EditionUpgrade + href: wcd-editionupgrade.md +- name: FirewallConfiguration + href: wcd-firewallconfiguration.md +- name: FirstExperience + href: wcd-firstexperience.md +- name: Folders + href: wcd-folders.md +- name: HotSpot + href: wcd-hotspot.md +- name: KioskBrowser + href: wcd-kioskbrowser.md +- name: Licensing + href: wcd-licensing.md +- name: Location + href: wcd-location.md +- name: Maps + href: wcd-maps.md +- name: NetworkProxy + href: wcd-networkproxy.md +- name: NetworkQOSPolicy + href: wcd-networkqospolicy.md +- name: OOBE + href: wcd-oobe.md +- name: Personalization + href: wcd-personalization.md +- name: Policies + href: wcd-policies.md +- name: Privacy + href: wcd-privacy.md +- name: ProvisioningCommands + href: wcd-provisioningcommands.md +- name: SharedPC + href: wcd-sharedpc.md +- name: SMISettings + href: wcd-smisettings.md +- name: Start + href: wcd-start.md +- name: StartupApp + href: wcd-startupapp.md +- name: StartupBackgroundTasks + href: wcd-startupbackgroundtasks.md +- name: StorageD3InModernStandby + href: wcd-storaged3inmodernstandby.md +- name: SurfaceHubManagement + href: wcd-surfacehubmanagement.md +- name: TabletMode + href: wcd-tabletmode.md +- name: TakeATest + href: wcd-takeatest.md +- name: Time + href: wcd-time.md +- name: UnifiedWriteFilter + href: wcd-unifiedwritefilter.md +- name: UniversalAppInstall + href: wcd-universalappinstall.md +- name: UniversalAppUninstall + href: wcd-universalappuninstall.md +- name: UsbErrorsOEMOverride + href: wcd-usberrorsoemoverride.md +- name: WeakCharger + href: wcd-weakcharger.md +- name: WindowsHelloForBusiness + href: wcd-windowshelloforbusiness.md +- name: WindowsTeamSettings + href: wcd-windowsteamsettings.md +- name: WLAN + href: wcd-wlan.md +- name: Workplace + href: wcd-workplace.md \ No newline at end of file