Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated group policy docs and picture of File Explorer page #5103

Draft
wants to merge 6 commits into
base: docs
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified hub/images/powertoys-settings-fileexplorer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
69 changes: 58 additions & 11 deletions hub/powertoys/grouppolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,18 +101,8 @@ These policies have a higher priority than, and will override, the policy "Confi
|Crop And Lock|Crop And Lock: Configure enabled state|ConfigureEnabledUtilityCropAndLock|
|Environment Variables|Environment Variables: Configure enabled state|ConfigureEnabledUtilityEnvironmentVariables|
|FancyZones|FancyZones: Configure enabled state|ConfigureEnabledUtilityFancyZones|
|File Explorer add-ons|File Explorer add-ons: Configure enabled state|ConfigureEnabledUtilityFileExplorerAddOns
|File Locksmith|File Locksmith: Configure enabled state|ConfigureEnabledUtilityFileLocksmith|
|Gcode file preview|Gcode file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerGcodePreview|
|Markdown file preview|Markdown file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerMarkdownPreview|
|PDF file preview|PDF file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerPDFPreview|
|QOI file preview|QOI file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerQOIPreview|
|Source code file preview|Source code file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerMonacoPreview|
|SVG file preview|SVG file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerSVGPreview|
|Gcode file thumbnail|Gcode file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerGcodeThumbnails|
|PDF file thumbnail|PDF file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerPDFThumbnails|
|QOI file thumbnail|QOI file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerQOIThumbnails|
|STL file thumbnail|STL file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerSTLThumbnails|
|SVG file thumbnail|SVG file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerSVGThumbnails|
|Hosts file editor|Hosts file editor: Configure enabled state|ConfigureEnabledUtilityHostsFileEditor|
|Image Resizer|Image Resizer: Configure enabled state|ConfigureEnabledUtilityImageResizer|
|Keyboard Manager|Keyboard Manager: Configure enabled state|ConfigureEnabledUtilityKeyboardManager|
Expand Down Expand Up @@ -728,3 +718,60 @@ You can set the enabled state for all plugins not controlled by this policy usin
> [!NOTE]
> Syntax for the :::no-loc text="value"::: property from the :::no-loc text="data"::: element:
> `<PluginID>&#xF000;<Number>&#xF000;<PluginID>&#xF000;<Number>`

### File Explorer add-ons

#### Configure enabled state for individual add-ons

Supported on PowerToys 0.64.0 or later, depending on the add-on.

For each File Explorer add-on, there's a "Configure enabled state" policy, which forces an enabled state for the add-on.

- If you enable this setting, the add-on will be always enabled and the user won't be able to disable it.
- If you disable this setting, the add-on 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 enable or disable the add-on.

The policy "File Explorer add-ons: Configure enabled state" will override this policy.

> [!NOTE]
> PDF file preview: There have been reports of incompatibility between the PDF Preview Handler and Outlook.

##### Table of utility Policies

| Utility | ADMX GP name |ADMX GP unique name /</br>Registry value name /</br>Intune PolicyID |
| :--- | :--- | :--- |
|Gcode file preview|Gcode file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerGcodePreview|
|Markdown file preview|Markdown file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerMarkdownPreview|
|PDF file preview|PDF file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerPDFPreview|
|QOI file preview|QOI file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerQOIPreview|
|Source code file preview|Source code file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerMonacoPreview|
|SVG file preview|SVG file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerSVGPreview|
|Gcode file thumbnail|Gcode file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerGcodeThumbnails|
|PDF file thumbnail|PDF file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerPDFThumbnails|
|QOI file thumbnail|QOI file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerQOIThumbnails|
|STL file thumbnail|STL file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerSTLThumbnails|
|SVG file thumbnail|SVG file thumbnail: Configure enabled state|ConfigureEnabledUtilityFileExplorerSVGThumbnails|

##### Group Policy (ADMX) information

- GP unique name: See the table above.
- GP name: See the table above.
- GP path: Administrative Templates/Microsoft PowerToys/File Explorer add-ons
- GP scope: Computer and user
- ADMX file name: _PowerToys.admx_

##### Registry information

- Path: Software\Policies\PowerToys
- Name: See the table above.
- Type: DWORD
- Example value: `0x00000000`

##### Intune information

- OMA-URI: `./Device/Vendor/MSFT/Policy/Config/PowerToys~Policy~PowerToys~FileExplorerAddOns/<PolicyID>`

> [!Note]
> Please see the table above for the _PolicyID_ value.

- Example value: `<disabled/>`