Skip to content

Commit b097575

Browse files
authored
clarify AllowExtensions group policy setting (#8680)
1 parent 5e88821 commit b097575

File tree

2 files changed

+17
-1
lines changed

2 files changed

+17
-1
lines changed

docs/setup/enterprise.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,18 @@ Refer to the [network common hostnames list](/docs/setup/network.md#common-hostn
2121
2222
The `extensions.allowed` application-wide setting in VS Code enables you to control which extensions can be installed on the user's machine. If the setting is not configured, all extensions are allowed. If the setting is configured, all extensions not listed are blocked from installing. If you block an extension or version that is already installed, the extension is disabled.
2323

24-
To [centrally manage](#centrally-manage-vs-code-settings) allowed extensions for your organization, configure the `AllowedExtensions` policy using your device management solution. This policy overrides the `extensions.allowed` setting on users' devices. The value of this policy is a JSON string that contains the allowed extensions.
24+
To [centrally manage](#centrally-manage-vs-code-settings) allowed extensions for your organization, configure the `AllowedExtensions` policy using your device management solution. This policy overrides the `extensions.allowed` setting on users' devices. The value of this policy is a JSON string that contains the allowed extensions:
25+
26+
```json
27+
{
28+
"github": true,
29+
"microsoft": true
30+
}
31+
```
32+
33+
This is how an administrator may locally configure the `AllowedExtensions` policy using the [Local Group Policy Editor](https://learn.microsoft.com/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/dn265982(v=ws.11)):
34+
35+
![Configuring AllowedExtensions from the Local Group Policy Editor](images/enterprise/allowed-extensions-local-gp-editor.png)
2536

2637
> [!IMPORTANT]
2738
> If there's a syntax error in the policy value, the `extensions.allowed` setting is not applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
@@ -133,6 +144,8 @@ VS Code has support for [Windows Registry-based Group Policy](https://learn.micr
133144

134145
Once the policy definitions are installed, admins can use the [Local Group Policy Editor](https://learn.microsoft.com/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/dn265982(v=ws.11)) to manage the policy values.
135146

147+
Products such as [Microsoft Intune](https://learn.microsoft.com/en-us/intune/intune-service/fundamentals/what-is-intune) may be used to centrally manage device policy at scale.
148+
136149
Policies can be set both at the Computer level and the User level. If both are set, Computer level will take precedence. When a policy value is set, the value overrides the VS Code [setting](/docs/configure/settings.md) value configured at any level (default, user, workspace, etc.).
137150

138151
### Configuration profiles on macOS
Lines changed: 3 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)