PowerShell CLI 2.0 - Cmdlets - Get-JS7FileTransferHistoryFile

Name

Get-JS7FileTransferHistoryFile

SYNOPSIS

Returns details about individual files that have been transferred using YADE

SYNTAX

Get-JS7FileTransferHistoryFile [[-ControllerId] <String>] [[-TransferId] <String[]>] [[-State] <String[]>] [[-SourceFile] <String[]>] [[-TargetFile] <String[]>] [[-Hash] <String>] [[-Limit] <Int32>] [<CommonParameters>]

DESCRIPTION

Information is returned for individual files transferred with YADE from a JS7 workflow.
Files can be selected by file name, history status, transfer identification etc.

The history information returned includes source file name, target file name, hash value, status etc. for transfer of an indivdual file.
A file transfer can includes any number of files. For information about individual files
the Get-JS7FileTransferFile cmdlet can be used.

This cmdlet can be used to pipeline the return of information about individual files like this:

$files = Get-JS7FileTransferHistory -RelativeDateFrom -1w -Successful | Get-JS7FileTransferHistoryFile

The following REST Web Service API resources are used:

* /yade/files

PARAMETERS

ControllerId

-ControllerId <String>
Optionally limits file transfer history items to workflows that have been executed which the indicated Controller.

TransferId

-TransferId <String[]>
Optionally specifies the identifier of a transfer operation as returned by the Get-JS7FileTransferHistory cmdlet like this:

$files = Get-JS7FileTransferHistory -RelativeDateFrom -1w -Successful | Get-JS7FileTransferHistoryFile

The Get-JS7FileTransferHistory is used to select file transfers by date and execution result.
The result includes the transfer identifier and is pipelined to the Get-JS7FileTransferHistoryFile cmdlet to
return file items included with the specified file transfers.

State

-State <String[]>
Optionally specifies the state of a file transfer to limit the file items returned.

This parameter accepts one or more of the following states:

* UNDEFINED
* WAITING
* TRANSFERRING
* IN_PROGRESS
* TRANSFERRED
* SUCCESS
* SKIPPED
* FAILED
* ABORTED
* COMPRESSED
* NOT_OVERWRITTEN
* DELETED
* RENAMED
* IGNORED_DUE_TO_ZEROBYTE_CONSTRAINT
* ROLLED_BACK
* POLLING

SourceFile

-SourceFile <String[]>
Optionally specifies the name of a source file to limit the file items returned.

This parameter accepts any number of source file names separated by a comma.

TargetFile

-TargetFile <String[]>
Optionally specifies the name of a target file to limit the file items returned.

This parameter accepts any number of target file names separated by a comma.

Hash

-Hash <String>
YADE can be configured to check the integrity of a file by a hash value.
The hash value is stored to the database and can be looked up by use of this parameter.

Limit

-Limit <Int32>

RELATED LINKS

about_JS7

EXAMPLES

-------------------------- EXAMPLE 1 --------------------------

PS > $items = Get-JS7FileTransferHistoryFile

Returns file items for today's file transfers.

-------------------------- EXAMPLE 2 --------------------------

PS > $items = Get-JS7FileTransferHistoryFile -Hash 'd41d8cd98f00b204e9800998ecf8427e'

Returns the file item for the file that matches the indicated hash.

-------------------------- EXAMPLE 3 --------------------------

PS > $items = Get-JS7FileTransferHistoryFile -SourceFile accounting.csv

Returns file items for the indicated file name.

-------------------------- EXAMPLE 4 --------------------------

PS > $items = Get-JS7FileTransferHistoryFile -TransferId 32767

Returns the file item for the file transfer identified with the indicated key. The identifier for a file transfer can be retrieved by use of the Get-JS7FileTransferHistory cmdlet.

-------------------------- EXAMPLE 5 --------------------------

PS > $files = Get-JS7FileTransferHistory -RelativeDateFrom -1w -Successful | Get-JS7FileTransferHistoryFile

Returns the file items for file transfers performed since begin of the week that completed successfully.