SSRestor.exe restores information from a previously created archive.
Syntax
SSRESTOR [-pProject] [-l] [-t] [-s] [-o] [-i-] [-y] [-x] [-c] <archive file to restore> [files/projects]
The following table describes command-line options available with this command.
Option | Description |
[-p] | Specifies a project to restore into. |
[-l] | List. |
[-la] | List all |
[-t] | Test the archive file for corruption, but do nothing else. |
[-s] | Specifies a path to SRCSAFE.INI and the data directory. |
[-o] | Redirects output (standard VSS parameter). |
[-i-] | No input (standard VSS parameter). |
[-y] | Username,Password (standard VSS parameter). |
[-x] | Identifies which item to restore when the item has been deleted from the project. -x means restore the deleted item. For example, assume you have both a deleted and non-deleted $/a/b. If you archive and delete $/a, you actually get three projects ($/a, $/a/b, and $/a/b) deleted. What, therefore, does ssrestor $/a/b really mean? If you don't specify -x, it means use the non-deleted $/a/b. If you do specify -x, it means restore the deleted $/a/b. Even though they have the same name, these are two different projects. |
[-c] | Specifies the comment applied to the history entry for the restored item(s). |
The -p option specifies a project to restore into. For instance, if you archive off $/A/BAR.C and then restore it, it will be restored as $/A/BAR.C
. Use the -p parameter only if you want to restore the file into a different project.
Note If restoring attempts to create a duplicate file or project name, the restore fails.
The -l option specifies “don’t restore anything, just list what’s in this archive file.” Suppose you archived $/A into this archive file. If you use –l, it will simply tell you that $/A is there. If you use –la, it will actually show you all the files and subprojects under $/A. In general, -l only shows you the items you explicitly put into the file; -la shows you all the child projects and files.
The -t option is analogous to pkunzip -t. It says, “don’t actually restore this archive, just let me know whether it is corrupt.”
The -s option is described in detail under SSARC.EXE.
The –o and -i- options are standard VSS options.
As with SSARC, the -y option lets you specify the administrator’s password. For example:
-yAdmin,Moggy