Save-VaultFile

Downloads a file from Vault to a local directory.

Syntax

Save-VaultFile -File <String> [-DownloadDirectory <String>] [-Version <VersionGatheringOption>] [-ExcludeChildren] [-NoRecursiveChildren] [-NotOverride] [-IncludeAttachments] [-IncludeHiddenEntities] [-IncludeParents] [-RecursiveParents][-IncludeRelatedDocumentation] [<CommonParameters>]

Parameters

Type	Name	Description	Default value	Optional
String	File	Path to the file, which should be downloaded		no
String	DownloadDirectory	Absolute Path to a local file. If NOT set, it will download the file to the vault workspace. If the target directory doesn’t exist it will be created		yes
Enum	Version	Version of the related files to be downloaded. Possible values are: Latest, Actual and Revision	Latest	yes
SwitchParameter	ExcludeChildren	Children of the source file will be excluded		yes
SwitchParameter	NoRecursiveChildren	Only the first level of children will be included		yes
SwitchParameter	ExcludeLibaryContents	Entities that are a part of a Vault Library will be excluded		yes
SwitchParameter	NotOverride	Folder/Files will not be overwritten, if they already exists		yes
SwitchParameter	IncludeAttachments	Attachments of the file will be included		yes
SwitchParameter	IncludeHiddenEntities	Hidden entities will be included		yes
SwitchParameter	IncludeParents	Parents of the source file will be included		yes
SwitchParameter	RecursiveParents	Parents will be included recursively		yes
SwitchParameter	IncludeRelatedDocumentation	The related documentation of the source file will be included. For example, a DWG might be considered related documentation for an assembly. The DWG is not considered an attachment or a dependent		yes

Return type

File[] ← on success
empty ← on failure. Exception/ErrorMessage can be accessed using $Error.

Remarks

The cmdlet downloads a file from the Vault Server to a local directory.

The result of the cmdlet contains a list of all the downloaded files.
Each of those files have an additional property ‘LocalPath’ containing the full path (including the file name) of the downloaded file.

Examples

Download a File

$result = Save-VaultFile -File "$/Designs/Sample/Not.iam" -DownloadDirectory "C:\temp\Vault\Sample\"
$result[0].LocalPath #Returns C:\temp\Vault\Sample\Not.iam

Download a File to the vault workspace including related documentation files

$result = Save-VaultFile -File "$/Designs/Sample/Not.iam" -IncludeRelatedDocumentation