Skip to content

Commit 46b9f84

Browse files
authored
Merge pull request #3165 from MicrosoftDocs/main638043171074154230sync_temp
For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents f84437a + 3a31d85 commit 46b9f84

File tree

2 files changed

+45
-0
lines changed

2 files changed

+45
-0
lines changed

hub/dev-environment/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,8 @@ items:
7777
href: ../powertoys/install.md
7878
- name: Run in admin mode
7979
href: ../powertoys/administrator.md
80+
- name: Group Policy
81+
href: ../powertoys/grouppolicy.md
8082
- name: Report a Bug
8183
href: ../powertoys/reportBug.md
8284
- name: Always on Top

hub/powertoys/grouppolicy.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: PowerToys Group Policy
3+
description: Gropu policy objects
4+
ms.date: 10/26/2022
5+
ms.topic: article
6+
no-loc: [PowerToys, Windows, Group Policy, Win]
7+
---
8+
9+
# Group Policy Objects
10+
11+
Since version 0.64, PowerToys is released on GitHub with [GroupPolicyObject files](/previous-versions/windows/desktop/policy/group-policy-objects). You can check these releases on https://github.com/microsoft/PowerToys/releases .
12+
13+
## How to install
14+
15+
A Group Policy Object is a virtual collection of policy settings with a unique name, such as a GUID, and represent policy settings in the file system and in the Active Directory. To install the PowerToys group policy follow these steps:
16+
17+
### Add the administrative template to an individual computer
18+
19+
1. Copy the "PowerToys.admx" file to your Policy Definition template folder. (Example: `C:\Windows\PolicyDefinitions`)
20+
2. Copy the "PowerToys.adml" file to the matching language folder in your Policy Definition folder. (Example: `C:\Windows\PolicyDefinitions\en-US`)
21+
22+
### Add the administrative template to Active Directory
23+
24+
1. On a domain controller or workstation with [RSAT](/troubleshoot/windows-server/system-management-components/remote-server-administration-tools), go to the **PolicyDefinition** folder (also known as the *Central Store*) on any domain controller for your domain. For older versions of Windows Server, you might need to create the **PolicyDefinition** folder. For more information, see [How to create and manage the Central Store for Group Policy Administrative Templates in Windows](https://support.microsoft.com/help/3087759/how-to-create-and-manage-the-central-store-for-group-policy-administra).
25+
2. Copy the "PowerToys.admx" file to the PolicyDefinition folder. (Example: `%systemroot%\sysvol\domain\policies\PolicyDefinitions`)
26+
3. Copy the "PowerToys.adml" file to the matching language folder in the PolicyDefinition folder. Create the folder if it doesn't already exist. (Example: `%systemroot%\sysvol\domain\policies\PolicyDefinitions\EN-US`)
27+
4. If your domain has more than one domain controller, the new [ADMX files](/troubleshoot/windows-client/group-policy/create-and-manage-central-store) will be replicated to them at the next domain replication interval.
28+
29+
### Scope
30+
31+
You will find the policies under "Administrative Templates/Microsoft PowerToys" in both the Computer Configuration and User Configuration folders. If both settings are configured, the setting in Computer Configuration takes precedence over the setting in User Configuration.
32+
33+
## Policies
34+
35+
Policy can force a PowerToys utility to be enabled or disabled for users covered by the policy.
36+
37+
### Configure enabled state
38+
39+
For each utility shipped with PowerToys, there's a "Configure enabled state" policy, which forces an **enabled** state for the utility.
40+
41+
- If you enable this setting, the utility will be always enabled and the user won't be able to disable it.
42+
- If you disable this setting, the utility will be always disabled and the user won't be able to enable it.
43+
- If you don't configure this setting, users are able to disable or enable the utility at their own discretion.

0 commit comments

Comments
 (0)