hpcfile get

 

Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2

Downloads one or more files from a cluster node. You can download the files to the local computer or to a shared folder on the network.

Note

This subcommand was introduced in HPC Pack 2008 R2 with Service Pack 1 and is not supported in previous versions.

Syntax

hpcfile get [/scheduler:{address}] [/head:{length}] [/tail:{length}] 
 [/quiet:{true|false}] [/lines:{true|false}] [/targetnode:{node}] [/file:{path}] 
 [/destfile:{path}] [/encoding:{encoding}] [/stdout:{true|false}]

hpcfile get {/? | /help}

Parameters

Parameter	Description
/scheduler	Specifies the name of the cluster head node.
/targetnode	Specifies the name of the cluster node. You can only specify one target node.
/file	Specifies the fully qualified path of the source file (that is, the file that you want to download). You can use the asterisk (*) as a wild card character. For example, to download all text files in C:\Users\myName, specify: C:\Users\myName\*.txt
/destfile	Specifies the fully qualified path of the destination folder (that is, where you want to save the downloaded files). This can be a path on the local computer, or a path to a shared folder on the network. If not specified, hpcfile downloads the files to the current directory on the local computer. If you are downloading a single file and want it saved with a different name, you can specify a file name. For example, C:\Users\myName\myCopy.txt.
/encoding	Specifies the encoding of the source file. If this parameter is not specified, the encoding is determined by examining the first several bytes of the file. UTF-8, little-endian Unicode, and big-endian Unicode are automatically recognized. You should specify this parameter when the encoding of the source file cannot be automatically recognized.
/head	If specified, the command operates on the first <length> bytes or lines of the file. For example, to operate on the first 4 KB of a file, specify the parameter as follows: /head:4096. This example requires /lines to be set to false.
/lines	When /lines is set to false (default), the <length> value of the /head or /tail parameter is interpreted as the number of bytes. When true, the <length> value of the /head or /tail parameter is interpreted as the number of lines. The short form of this option is /l.
/tail	If specified, the command only operates on the last <length> bytes or lines of the file. For example, to operate on the last 4 KB of a file, specify the parameter as follows: /tail:4096. This example requires /lines to be set to false.
/quiet	If specified, the utility will always overwrite the destination file (if it exists) instead of prompting. The short form of this option is /q.
/stdout	When true, the contents of each file are written to stdout. This option cannot be used if a destination file is specified. The short form of this parameter is /o.
/?	Displays Help at the command prompt.
/help	Displays Help at the command prompt.

Examples

To download all text files (.txt) from C:\Users\myName on NODE002 and save them to C:\myFiles on the local computer:

hpcFile get /scheduler:myHeadNode /targetNode:NODE002 /file: "C:\Users\myName\*.txt" /destFile: "C:\myFiles"

To download C:\Users\myName\myLog.txt from NODE002 and save it as C:\myFiles\myLogNODE002.txt on the local computer:

hpcFile get /scheduler:myHeadNode /targetNode:NODE002 /file: "C:\Users\myName\myLog.txt" /destFile: "C:\myFiles\myLogNODE002.txt"