[GPO]Add setting to disallow experimentation (#24131)

* [GPO]Add policy to disallow experimentation * Refresh experimentation setting UI * Reflect gpo value in Settings UI * Fix adml errors * Update src/settings-ui/Settings.UI/Strings/en-us/Resources.resw * Update src/settings-ui/Settings.UI/Strings/en-us/Resources.resw * Update src/gpo/assets/en-US/PowerToys.adml * Small grammar fixes * Update src/gpo/assets/en-US/PowerToys.adml --------- Co-authored-by: Heiko <61519853+htcfreek@users.noreply.github.com>
2025-06-07 01:08:18 +08:00 · 2023-02-17 21:23:39 +00:00 · 2023-02-17 21:23:39 +00:00 · 27d8beb0cb
commit 27d8beb0cb
parent df521b4c9b
11 changed files with 79 additions and 13 deletions
--- a/doc/gpo/README.md
+++ b/doc/gpo/README.md
@ -31,3 +31,11 @@ If you enable this setting, the utility will be always enabled and the user won'
 If you disable this setting, the utility will be always disabled and the user won't be able to enable it.

 If you don't configure this setting, users are able to disable or enable the utility.
+
+### Allow experimentation
+
+This policy configures whether PowerToys experimentation is allowed.
+
+Disable this setting to disable the experimentation features in PowerToys, meaning the user won't see the new features being experimented even if it gets selected as part of the test group.
+
+If this setting is not configured, experimentation is allowed.
--- a/src/common/GPOWrapper/GPOWrapper.cpp
+++ b/src/common/GPOWrapper/GPOWrapper.cpp
@ -112,4 +112,8 @@ namespace winrt::PowerToys::GPOWrapper::implementation
    {
        return static_cast<GpoRuleConfigured>(powertoys_gpo::getConfiguredVideoConferenceMuteEnabledValue());
    }
+    GpoRuleConfigured GPOWrapper::GetAllowExperimentationValue()
+    {
+        return static_cast<GpoRuleConfigured>(powertoys_gpo::getAllowExperimentationValue());
+    }
 }
--- a/src/common/GPOWrapper/GPOWrapper.h
+++ b/src/common/GPOWrapper/GPOWrapper.h
@ -34,6 +34,7 @@ namespace winrt::PowerToys::GPOWrapper::implementation
        static GpoRuleConfigured GetConfiguredShortcutGuideEnabledValue();
        static GpoRuleConfigured GetConfiguredTextExtractorEnabledValue();
        static GpoRuleConfigured GetConfiguredVideoConferenceMuteEnabledValue();
+        static GpoRuleConfigured GetAllowExperimentationValue();
    };
 }

--- a/src/common/GPOWrapper/GPOWrapper.idl
+++ b/src/common/GPOWrapper/GPOWrapper.idl
@ -38,6 +38,7 @@ namespace PowerToys
            static GpoRuleConfigured GetConfiguredShortcutGuideEnabledValue();
            static GpoRuleConfigured GetConfiguredTextExtractorEnabledValue();
            static GpoRuleConfigured GetConfiguredVideoConferenceMuteEnabledValue();
+            static GpoRuleConfigured GetAllowExperimentationValue();
        }
    }
 }
--- a/src/common/utils/gpo.h
+++ b/src/common/utils/gpo.h
@ -46,6 +46,7 @@ namespace powertoys_gpo {
    const std::wstring POLICY_CONFIGURE_ENABLED_SHORTCUT_GUIDE = L"ConfigureEnabledUtilityShortcutGuide";
    const std::wstring POLICY_CONFIGURE_ENABLED_TEXT_EXTRACTOR = L"ConfigureEnabledUtilityTextExtractor";
    const std::wstring POLICY_CONFIGURE_ENABLED_VIDEO_CONFERENCE_MUTE = L"ConfigureEnabledUtilityVideoConferenceMute";
+    const std::wstring POLICY_ALLOW_EXPERIMENTATION = L"AllowExperimentation";

    inline gpo_rule_configured_t getConfiguredValue(const std::wstring& registry_value_name)
    {
@ -235,4 +236,9 @@ namespace powertoys_gpo {
        return getConfiguredValue(POLICY_CONFIGURE_ENABLED_VIDEO_CONFERENCE_MUTE);
    }

+    inline gpo_rule_configured_t getAllowExperimentationValue()
+    {
+        return getConfiguredValue(POLICY_ALLOW_EXPERIMENTATION);
+    }
+
 }
--- a/src/gpo/assets/PowerToys.admx
+++ b/src/gpo/assets/PowerToys.admx
@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- Copyright (c) Microsoft Corporation.
     Licensed under the MIT License. -->
-<policyDefinitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
+<policyDefinitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.1" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
  <policyNamespaces>
    <target prefix="powertoys" namespace="Microsoft.Policies.PowerToys" />
  </policyNamespaces>
-  <resources minRequiredRevision="1.0"/><!-- PowerToys v0.64.0 -->
+  <resources minRequiredRevision="1.1"/><!-- Last changed with PowerToys v0.68.0 -->
  <supportedOn>
    <definitions>
      <definition name="SUPPORTED_POWERTOYS_0_64_0" displayName="$(string.SUPPORTED_POWERTOYS_0_64_0)"/>
+      <definition name="SUPPORTED_POWERTOYS_0_68_0" displayName="$(string.SUPPORTED_POWERTOYS_0_68_0)"/>
    </definitions>
  </supportedOn>
  <categories>
@ -286,5 +287,15 @@
        <decimal value="0" />
      </disabledValue>
    </policy>
+    <policy name="AllowExperimentation" class="Both" displayName="$(string.AllowExperimentation)" explainText="$(string.AllowExperimentationDescription)" key="Software\Policies\PowerToys" valueName="AllowExperimentation">
+      <parentCategory ref="PowerToys" />
+      <supportedOn ref="SUPPORTED_POWERTOYS_0_68_0" />
+      <enabledValue>
+        <decimal value="1" />
+      </enabledValue>
+      <disabledValue>
+        <decimal value="0" />
+      </disabledValue>
+    </policy>
  </policies>
 </policyDefinitions>
--- a/src/gpo/assets/en-US/PowerToys.adml
+++ b/src/gpo/assets/en-US/PowerToys.adml
@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- Copyright (c) Microsoft Corporation.
     Licensed under the MIT License. -->
-<policyDefinitionResources xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
+<policyDefinitionResources xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.1" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
  <displayName>PowerToys</displayName>
  <description>PowerToys</description>
  <resources>
@ -9,6 +9,7 @@
      <string id="PowerToys">Microsoft PowerToys</string>

      <string id="SUPPORTED_POWERTOYS_0_64_0">PowerToys version 0.64.0 or later</string>
+      <string id="SUPPORTED_POWERTOYS_0_68_0">PowerToys version 0.68.0 or later</string>

      <string id="ConfigureEnabledUtilityDescription">This policy configures the enabled state for a PowerToys utility.

@ -27,6 +28,12 @@ If you enable this setting, the utility will be always enabled and the user won'
 If you disable this setting, the utility will be always disabled and the user won't be able to enable it.

 If you don't configure this setting, users are able to disable or enable the utility.
+</string>
+      <string id="AllowExperimentationDescription">This policy configures whether PowerToys experimentation is allowed. With experimentation allowed the user sees the new features being experimented if it gets selected as part of the test group. (Experimentation will only happen on Windows Insider builds.)
+
+If this setting is not configured or enabled, the user can control experimentation in the PowerToys settings menu.
+
+If this setting is disabled, experimentation is not allowed.
 </string>
      <string id="ConfigureEnabledUtilityAlwaysOnTop">Always On Top: Configure enabled state</string>
      <string id="ConfigureEnabledUtilityAwake">Awake: Configure enabled state</string>
@ -55,6 +62,7 @@ If you don't configure this setting, users are able to disable or enable the uti
      <string id="ConfigureEnabledUtilityShortcutGuide">Shortcut Guide: Configure enabled state</string>
      <string id="ConfigureEnabledUtilityTextExtractor">Text Extractor: Configure enabled state</string>
      <string id="ConfigureEnabledUtilityVideoConferenceMute">Video Conference Mute: Configure enabled state</string>
+      <string id="AllowExperimentation">Allow Experimentation</string>
    </stringTable>
  </resources>
 </policyDefinitionResources>
--- a/src/settings-ui/Settings.UI/OOBE/Views/OobeShellPage.xaml.cs
+++ b/src/settings-ui/Settings.UI/OOBE/Views/OobeShellPage.xaml.cs
@ -6,6 +6,7 @@ using System;
 using System.Collections.ObjectModel;
 using System.Globalization;
 using AllExperiments;
+using global::PowerToys.GPOWrapper;
 using Microsoft.PowerToys.Settings.UI.Library;
 using Microsoft.PowerToys.Settings.UI.OOBE.Enums;
 using Microsoft.PowerToys.Settings.UI.OOBE.ViewModel;
@ -195,7 +196,7 @@ namespace Microsoft.PowerToys.Settings.UI.OOBE.Views
                switch (selectedItem.Tag)
                {
                    case "Overview":
-                        if (ExperimentationToggleSwitchEnabled)
+                        if (ExperimentationToggleSwitchEnabled && GPOWrapper.GetAllowExperimentationValue() != GpoRuleConfigured.Disabled)
                        {
                            switch (AllExperiments.Experiments.LandingPageExperiment)
                            {
--- a/src/settings-ui/Settings.UI/Strings/en-us/Resources.resw
+++ b/src/settings-ui/Settings.UI/Strings/en-us/Resources.resw
@ -2922,11 +2922,17 @@ Activate by holding the key for the character you want to add an accent to, then
  <data name="Alternate_OOBE_Run_Title.Text" xml:space="preserve">
    <value>PowerToys Run</value>
  </data>
+  <data name="General_Experimentation.Header" xml:space="preserve">
+    <value>Experimentation</value>
+  </data>
  <data name="GeneralPage_EnableExperimentation.Description" xml:space="preserve">
-    <value>Only affects Windows Insider builds</value>
+    <value>Note: Only Windows Insider builds may be selected for experimentation</value>
  </data>
  <data name="GeneralPage_EnableExperimentation.Header" xml:space="preserve">
-    <value>Enable experimentation</value>
+    <value>Allow experimentation with new features</value>
+  </data>
+  <data name="GPO_ExperimentationIsDisallowed.Title" xml:space="preserve">
+    <value>The system administrator has disabled experimentation.</value>
  </data>
  <data name="AllAppsTxt.Text" xml:space="preserve">
    <value>All apps</value>
--- a/src/settings-ui/Settings.UI/ViewModels/GeneralViewModel.cs
+++ b/src/settings-ui/Settings.UI/ViewModels/GeneralViewModel.cs
@ -12,6 +12,7 @@ using System.Reflection;
 using System.Runtime.CompilerServices;
 using System.Text.Json;
 using System.Threading.Tasks;
+using global::PowerToys.GPOWrapper;
 using Microsoft.PowerToys.Settings.UI.Library;
 using Microsoft.PowerToys.Settings.UI.Library.Helpers;
 using Microsoft.PowerToys.Settings.UI.Library.Interfaces;
@ -140,6 +141,8 @@ namespace Microsoft.PowerToys.Settings.UI.ViewModels
            _newAvailableVersionLink = UpdatingSettingsConfig.ReleasePageLink;
            _updateCheckedDate = UpdatingSettingsConfig.LastCheckedDateLocalized;

+            _experimentationIsGpoDisallowed = GPOWrapper.GetAllowExperimentationValue() == GpoRuleConfigured.Disabled;
+
            if (dispatcherAction != null)
            {
                _fileWatcher = Helper.GetFileWatcher(string.Empty, UpdatingSettings.SettingsFile, dispatcherAction);
@ -154,6 +157,7 @@ namespace Microsoft.PowerToys.Settings.UI.ViewModels

        private bool _autoDownloadUpdates;
        private bool _enableExperimentation;
+        private bool _experimentationIsGpoDisallowed;

        private UpdatingSettings.UpdatingState _updatingState = UpdatingSettings.UpdatingState.UpToDate;
        private string _newAvailableVersion = string.Empty;
@ -290,7 +294,7 @@ namespace Microsoft.PowerToys.Settings.UI.ViewModels
        {
            get
            {
-                return _enableExperimentation;
+                return _enableExperimentation && !_experimentationIsGpoDisallowed;
            }

            set
@ -304,6 +308,11 @@ namespace Microsoft.PowerToys.Settings.UI.ViewModels
            }
        }

+        public bool IsExperimentationGpoDisallowed
+        {
+            get => _experimentationIsGpoDisallowed;
+        }
+
        public static bool AutoUpdatesEnabled
        {
            get
--- a/src/settings-ui/Settings.UI/Views/GeneralPage.xaml
+++ b/src/settings-ui/Settings.UI/Views/GeneralPage.xaml
@ -369,12 +369,6 @@
                            </labs:SettingsCard>
                        </labs:SettingsExpander.Items>
                    </labs:SettingsExpander>
-                    <labs:SettingsCard x:Uid="GeneralPage_EnableExperimentation"
-                                       HeaderIcon="{ui:BitmapIcon Source=/Assets/FluentIcons/FluentIconsExperimentation.png}">
-                        <ToggleSwitch
-                            x:Uid="ToggleSwitch"
-                            IsOn="{Binding Mode=TwoWay, Path=EnableExperimentation}" />
-                    </labs:SettingsCard>
                </controls:SettingsGroup>
                <InfoBar
                    x:Uid="General_SettingsBackupMessageResults"
@ -383,6 +377,23 @@
                    IsOpen="{Binding SettingsBackupRestoreMessageVisible, Mode=OneWay}"
                    IsTabStop="{Binding SettingsBackupRestoreMessageVisible, Mode=OneWay}"
                    Severity="{Binding BackupRestoreMessageSeverity, Converter={StaticResource StringToInfoBarSeverityConverter}}" />
+                <controls:SettingsGroup
+                    x:Uid="General_Experimentation"
+                    Visibility="Visible">
+                    <labs:SettingsCard x:Uid="GeneralPage_EnableExperimentation"
+                                       HeaderIcon="{ui:BitmapIcon Source=/Assets/FluentIcons/FluentIconsExperimentation.png}">
+                        <ToggleSwitch
+                            x:Uid="ToggleSwitch"
+                            IsEnabled="{x:Bind Mode=OneWay, Path=ViewModel.IsExperimentationGpoDisallowed, Converter={StaticResource BoolNegationConverter}}"
+                            IsOn="{Binding Mode=TwoWay, Path=EnableExperimentation}" />
+                    </labs:SettingsCard>
+                    <InfoBar
+                        x:Uid="GPO_ExperimentationIsDisallowed"
+                        IsClosable="False"
+                        IsOpen="{x:Bind Mode=OneWay, Path=ViewModel.IsExperimentationGpoDisallowed}"
+                        IsTabStop="{x:Bind Mode=OneWay, Path=ViewModel.IsExperimentationGpoDisallowed}"
+                        Severity="Informational" />
+                </controls:SettingsGroup>
            </StackPanel>

        </controls:SettingsPageControl.ModuleContent>