windows-itpro-docs/windows/client-management/mdm/policy-csp-admx-workfoldersclient.md
2022-10-24 18:49:24 -04:00

7.2 KiB
Raw Blame History

title, description, ms.author, ms.localizationpriority, ms.topic, ms.prod, ms.technology, author, ms.date, ms.reviewer, manager
title description ms.author ms.localizationpriority ms.topic ms.prod ms.technology author ms.date ms.reviewer manager
Policy CSP - ADMX_WorkFoldersClient Policy CSP - ADMX_WorkFoldersClient vinpa medium article windows-client itpro-manage vinaypamnani-msft 09/22/2021 aaroncz

Policy CSP - ADMX_WorkFoldersClient

Tip

This is an ADMX-backed policy and requires a special SyncML format to enable or disable. For details, see Understanding ADMX-backed policies.

You must specify the data type in the SyncML as <Format>chr</Format>. For an example SyncML, refer to Enabling a policy.

The payload of the SyncML must be XML-encoded; for this XML encoding, there are a variety of online encoders that you can use. To avoid encoding the payload, you can use CDATA if your MDM supports it. For more information, see CDATA Sections.


ADMX_WorkFoldersClient policies

ADMX_WorkFoldersClient/Pol_UserEnableTokenBroker
ADMX_WorkFoldersClient/Pol_UserEnableWorkFolders
ADMX_WorkFoldersClient/Pol_MachineEnableWorkFolders

ADMX_WorkFoldersClient/Pol_UserEnableTokenBroker

Edition Windows 10 Windows 11
Home No No
Pro Yes Yes
Windows SE No Yes
Business Yes Yes
Enterprise Yes Yes
Education Yes Yes

Scope:

[!div class = "checklist"]

  • Device

This policy setting specifies whether Work Folders should be set up automatically for all users of the affected computer.

  • If you enable this policy setting, Work Folders will be set up automatically for all users of the affected computer.

This folder creation prevents users from choosing not to use Work Folders on the computer; it also prevents them from manually specifying the local folder in which Work Folders stores files. Work Folders will use the settings specified in the "Specify Work Folders settings" policy setting in User Configuration\Administrative Templates\Windows Components\WorkFolders. If the "Specify Work Folders settings" policy setting doesn't apply to a user, Work Folders isn't automatically set up.

  • If you disable or don't configure this policy setting, Work Folders uses the "Force automatic setup" option of the "Specify Work Folders settings" policy setting to determine whether to automatically set up Work Folders for a given user.

ADMX Info:

  • GP Friendly name: Force automatic setup for all users
  • GP name: Pol_UserEnableTokenBroker
  • GP path: Windows Components\Work Folders
  • GP ADMX file name: WorkFoldersClient.admx

ADMX_WorkFoldersClient/Pol_UserEnableWorkFolders

Edition Windows 10 Windows 11
Home No No
Pro Yes Yes
Windows SE No Yes
Business Yes Yes
Enterprise Yes Yes
Education Yes Yes

Scope:

[!div class = "checklist"]

  • User

This policy setting specifies the Work Folders server for affected users, and whether or not users are allowed to change settings when setting up Work Folders on a domain-joined computer.

  • If you enable this policy setting, affected users receive Work Folders settings when they sign in to a domain-joined PC.

If this policy setting is disabled or not configured, no Work Folders settings are specified for the affected users, though users can manually set up Work Folders by using the Work Folders Control Panel item. The "Work Folders URL" can specify either the URL used by the organization for Work Folders discovery, or the specific URL of the file server that stores the affected users' data. The "Work Folders Local Path" specifies the local folder used on the client machine to sync files. This path may contain environment variables.

Note

In order for this configuration to take effect, a valid 'Work Folders URL' must also be specified.

The “On-demand file access preference” option controls whether to enable on-demand file access. When enabled, the user controls which files in Work Folders are available offline on a given PC. The rest of the files in Work Folders are always visible and dont take up any space on the PC, but the user must be connected to the Internet to access them. If you enable this policy setting, on-demand file access is enabled.

  • If you disable this policy setting, on-demand file access is disabled, and enough storage space to store all the users files is required on each of their PCs.

If you specify User choice or don't configure this policy setting, the user decides whether to enable on-demand file access. However, if the Force automatic setup policy setting is enabled, Work Folders is set up automatically with on-demand file access enabled.

The "Force automatic setup" option specifies that Work Folders should be set up automatically without prompting users. This automatic setup prevents users from choosing not to use Work Folders on the computer; it also prevents them from manually specifying the local folder in which Work Folders stores files. By default, Work Folders is stored in the "%USERPROFILE%\Work Folders" folder. If this option isn't specified, users must use the Work Folders Control Panel item on their computers to set up Work Folders.

ADMX Info:

  • GP Friendly name: Specify Work Folders settings
  • GP name: Pol_UserEnableWorkFolders
  • GP path: Windows Components\Work Folders
  • GP ADMX file name: WorkFoldersClient.admx

ADMX_WorkFoldersClient/Pol_MachineEnableWorkFolders

Edition Windows 10 Windows 11
Home No No
Pro Yes Yes
Windows SE No Yes
Business Yes Yes
Enterprise Yes Yes
Education Yes Yes

Scope:

[!div class = "checklist"]

  • User

This policy specifies whether Work Folders should use Token Broker for interactive AD FS authentication instead of its own OAuth2 token flow used in previous versions.

ADMX Info:

  • GP Friendly name: Enables the use of Token Broker for AD FS authentication
  • GP name: Pol_MachineEnableWorkFolders
  • GP path: Windows Components\Work Folders
  • GP ADMX file name: WorkFoldersClient.admx