You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/setup/enterprise.md
+18-11Lines changed: 18 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,9 @@ Refer to the [network common hostnames list](/docs/setup/network.md#common-hostn
20
20
21
21
## Configure allowed extensions
22
22
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.
24
26
25
27
> [!NOTE]
26
28
> 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"
80
82
81
83
If you want to learn more about extensions in VS Code, refer to the [extensions documentation](/docs/editor/extension-marketplace.md).
82
84
83
-
### Control allowed extensions via device management
85
+
### Centrally manage allowed extensions
84
86
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.
86
88
87
89
> [!IMPORTANT]
88
90
> 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
91
93
92
94
## Configure automatic updates
93
95
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.
95
97
96
98
The setting has the following options:
97
99
@@ -100,32 +102,37 @@ The setting has the following options:
100
102
*`start` - only check for updates when VS Code starts, automatic checking for updates is disabled
101
103
*`default` - automatic checking for updates is enabled and runs in the background periodically
102
104
103
-
### Control update mode via device management
105
+
### Centrally manage automatic updates
104
106
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.
106
108
107
109
## Device management
108
110
109
111
You can control specific features of VS Code through device management solutions to ensure it meets the needs of your organization.
110
112
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`|
112
119
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)).
115
122
116
123
### Group Policy on Windows
117
124
118
125
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.
119
126
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.
121
128
122
129
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.
123
130
124
131
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.).
125
132
126
133
### Additional policies
127
134
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.
0 commit comments