README.md

tfsutil

Utilities for working with TFS (Team Foundation Server)

Getting started

• Grab the latest release and unzip tfsutil to a location in your path.
• Create a config file using the command tfsutil config create. Save the generated text to a file named tfsutil.yml in the %userprofile% folder on windows (probably your user directory), or to your home directory (if on a unix/linux based platform), or in the same directory as the binary.
• Update the config file tfsutil.yml:
  • Set the TFS url with your server information
  • Set the default collection (you can always override this with the --collection command line flag)
  • Set the default project (you can always override this with the --project command line flag)
• Create a personal access token and set it in the tfsutil.yml config file. (Need help? See the guide on Microsoft's site.)

Listing variable groups

To list variable groups, execute the command:

tfsutil vg list

All variable groups for the current collection and project will be listed, along with the count of the variables in each group.

Copying a variable group

To copy a variable group, execute the command:

tfsutil vg copy "Special unicorn variables"

Where 'Special unicorn variables' is the name of the variable group you want to copy. Note: The variable group name should be surrounded with quotes.

Listing projects

To list projects, execute the command:

tfsutil project list

All projects for the current collection will be listed