TFVC Check-In Policies Copy link

TFVC projects can have check-in policies such as Build (Require last build was successful), Work Item (Require associated work item), Changeset comments policy (Require users to add comment to their check-in), etc. We are changing the way we store these policies on the server. This change will slightly affect TFVC users since they would need to initiate migration process from their side.

Phase I – User opt-in (Apr 2025) Copy link

This is a phase in progress. We provided means for users to start their migration process. Migration from obsolete policies to active ones should be done by the project administrator.

Using Visual Studio

Warning: Please ensure you updated Visual Studio to the latest version before proceeding (VS 2022, VS 2019 and VS 2017 with minimal versions 17.14 Preview 3, 17.13.6, 17.12.7, 17.10.13, 17.8.20, 16.11.46, 15.9.72 are supporting the new policies).

To create new policies using Visual Studio administrator should open Settings -> Team Project -> Source Control -> Check-in Policy. Next they should add new policy (without “Obsolete” mark) with the same parameters as old one:

Custom Policies

If you are using custom implementation of Microsoft.TeamFoundationServer.ExtendedClient to communicate with server, please follow the migration guide.

Phase II – Disable saving (~ Aug 2025) Copy link

The next phase in adapting new policies is disabling creation of obsolete policies. We will proceed with this phase in August 2025.

When we proceed with Phase II, service (including the latest versions of supported Azure DevOps Servers) will return an exception on any attempt to save obsolete policy. This exception will ask you to create policy in the new format.

Reading of obsolete policies will still be available and therefore they will still be working. But to avoid any future interruption in the workflow, policy migration is strongly recommended.

Phase III – Full disabling (~ Sep 2025) Copy link

This is the last phase of Azure DevOps moving to the new format. Planned time for this phase is September 2025. During it we will return exception on any attempt to read obsolete policies from service (including Azure DevOps Servers). Exception will notify user that operation not possible due to usage of obsolete policies.

At this phase only new policies will be available and working. No migration will be possible and not migrated policies will be lost. So customers will need to re-create them from scratch.