Skip to content

Commit f26674e

Browse files
committed
Improve wording device management
1 parent e305cc7 commit f26674e

File tree

1 file changed

+18
-11
lines changed

1 file changed

+18
-11
lines changed

docs/setup/enterprise.md

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,9 @@ Refer to the [network common hostnames list](/docs/setup/network.md#common-hostn
2020

2121
## Configure allowed extensions
2222

23-
The `extensions.allowed` application setting enables you to control which extensions can be installed in your organization. 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.
23+
Configure the `extensions.allowed` application-wide setting in VS Code to control which extensions can be installed. 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.
24+
25+
To centrally manage allowed extensions for your organization, use [device management](#centrally-manage-allowed-extensions) like Windows group policies, to create a policy that overrides the VS Code setting on individual devices.
2426

2527
> [!NOTE]
2628
> Support for allowed extensions is available starting from VS Code version 1.96.
@@ -80,9 +82,9 @@ Duplicate key values are not supported. For example, including both `"microsoft"
8082

8183
If you want to learn more about extensions in VS Code, refer to the [extensions documentation](/docs/editor/extension-marketplace.md).
8284

83-
### Control allowed extensions via device management
85+
### Centrally manage allowed extensions
8486

85-
You can control the `extensions.allowed` setting by using [device management](#device-management). Use the `AllowedExtensions` VS Code policy, which overrides the `extensions.allowed` setting. The value of this policy is a JSON string that contains the allowed extensions.
87+
Use [device management](#device-management) to centrally control which extensions are allowed to be installed in your organization. Configure the `AllowedExtensions` VS Code policy to override the corresponding `extensions.allowed` VS Code setting on users' devices. The value of this policy is a JSON string that contains the allowed extensions.
8688

8789
> [!IMPORTANT]
8890
> 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**). In the Settings editor (`kb(workbench.action.openSettings)`), you can see a warning message for the `Extensions: Allowed` setting that the setting value was not applied.
@@ -91,7 +93,7 @@ You can control the `extensions.allowed` setting by using [device management](#d
9193

9294
## Configure automatic updates
9395

94-
The `update.mode` setting controls whether VS Code automatically updates when a new version is released. The updates are fetched from a Microsoft online service.
96+
The `update.mode` VS Code setting controls whether VS Code automatically updates when a new version is released. The updates are fetched from a Microsoft online service.
9597

9698
The setting has the following options:
9799

@@ -100,32 +102,37 @@ The setting has the following options:
100102
* `start` - only check for updates when VS Code starts, automatic checking for updates is disabled
101103
* `default` - automatic checking for updates is enabled and runs in the background periodically
102104

103-
### Control update mode via device management
105+
### Centrally manage automatic updates
104106

105-
You can control the `update.mode` setting by using [device management](#device-management). Use the `UpdateMode` VS Code policy, which overrides the `update.mode` setting. The value of this policy is a string that contains the update mode.
107+
Use [device management](#device-management) to centrally control how VS Code manages updates across devices in your organization. Configure the `UpdateMode` VS Code policy, which overrides the corresponding `update.mode` VS Code setting on users's devices. The value of this policy is a string that contains the update mode.
106108

107109
## Device management
108110

109111
You can control specific features of VS Code through device management solutions to ensure it meets the needs of your organization.
110112

111-
### Admin-controlled features
113+
VS Code currently supports the following admin-controlled features:
114+
115+
| Policy | Description | VS Code setting |
116+
| ------ | ----------- | --------------- |
117+
| `AllowedExtensions` | Controls which extensions can be installed. | `extensions.allowed` |
118+
| `UpdateMode` | Controls whether VS Code automatically updates when a new version is released. | `update.mode` |
112119

113-
* Automatic updates (`update.mode`)
114-
* Allowed extensions (`extensions.allowed`)
120+
> [!NOTE]
121+
> Currently, VS Code only supports Windows group policies. Support for configuration profiles on macOS is coming soon ([tracking issue](https://github.com/microsoft/vscode/issues/148942)).
115122
116123
### Group Policy on Windows
117124

118125
System administrators need a way to control default software settings across all client machines in their organization. Group Policy is a client solution that gives administrators flexibility to implement the behavior for each of the available policies and settings.
119126

120-
VS Code now has support for [Windows Registry-based Group Policy](https://learn.microsoft.com/previous-versions/windows/desktop/policy/implementing-registry-based-policy). Starting from VS Code version 1.69, each release will ship with a `policies` directory containing ADMX template files that can be added to the following path: `C:\Windows\PolicyDefinitions`. Make sure to also copy the corresponding `adml` file to the `C:\Windows\PolicyDefinitions\<your-locale>` directory.
127+
VS Code has support for [Windows Registry-based Group Policy](https://learn.microsoft.com/previous-versions/windows/desktop/policy/implementing-registry-based-policy). Starting from VS Code version 1.69, each release ships with a `policies` directory containing ADMX template files that can be added to the following path: `C:\Windows\PolicyDefinitions`. Make sure to also copy the corresponding `adml` file to the `C:\Windows\PolicyDefinitions\<your-locale>` directory.
121128

122129
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.
123130

124131
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/getstarted/settings.md) value configured at any level (default, user, workspace, etc.).
125132

126133
### Additional policies
127134

128-
The goal is to promote current VS Code settings as Policies and closely follow existing settings, so that the naming and behavior are consistent. If there are requests to enact more policies, please open an issue in the VS Code [GitHub repository](https://github.com/microsoft/vscode/issues). The team will determine if there is already a corresponding setting for the behavior or if a new setting should be created to control the desired behavior.
135+
The goal is to promote current VS Code settings as policies and closely follow existing settings, so that the naming and behavior are consistent. If there are requests to enact more policies, please open an issue in the VS Code [GitHub repository](https://github.com/microsoft/vscode/issues). The team will determine if there is already a corresponding setting for the behavior or if a new setting should be created to control the desired behavior.
129136

130137
## Set up VS Code with preinstalled extensions
131138

0 commit comments

Comments
 (0)