<vssget>

Used to retreive an item or project from a Visual Source Safe database.

Parameters

Attribute Type Description Required
localpath string The absolute path to the local working directory. Required. True
recursive string Determines whether to perform the get recursively. Default value is true when omitted. False
removedeleted string Determines whether files marked "deleted" in the repository will be removed from the local copy. Default value is false when omitted. False
replace string Determines whether to replace writable files. Default value is false when omitted. False
usemodtime string Determines whether the timestamp on the local copy will be the modification time (if false or omitted, the checkout time will be used) False
writable string Determines whether the files will be read-only. Default value is false when omitted. False
dbpath string The absolute path to the folder that contains the srcsafe.ini. Required. True
path string The source safe project or file path, starting with "$/". Required. True
user string The user id to use to login to the Source Safe database. Required. True
failonerror bool False
if bool False
password string The password to use to login to the Source Safe database. False
unless bool False
verbose bool False
version string A version of the path to reference. Accepts multiple forms, including the label, version number, or date of the version. If omitted, the latest version is used. False

Examples

Get the latest files from a local sourcesafe database.

                <vssget
                  user="myusername"
                  password="mypassword"
                  localpath="C:\Dev\Latest"
                  recursive="true"
                  replace="true"
                  writable="true"
                  dbpath="C:\VSS\srcsafe.ini"
                  path="$/MyProduct"
                />
              

Get the latest version of a file from a remote sourcesafe database. Put it in a relative directory.

                <vssget
                  user="myusername"
                  password="mypassword"
                  localpath="Latest"
                  recursive="true"
                  replace="true"
                  writable="true"
                  dbpath="\\MyServer\VSS\srcsafe.ini"
                  path="$/MyProduct/myFile.cs"
                />
              

Get the latest version of a file from a remote sourcesafe database. Remove any deleted files from local image.

                <vssget
                  user="myusername"
                  password="mypassword"
                  localpath="C:\Dev\Latest"
                  recursive="true"
                  replace="true"
                  writable="true"
                  removedeleted="true"
                  dbpath="\\MyServer\VSS\srcsafe.ini"
                  path="$/MyProduct/myFile.cs"
                />