Write-SasFile modified by Andreas Menrath

Andreas Menrath — Mon, 14 Jul 2014 14:53:14 -0000

Write-SasFile modified by Andreas Menrath

Andreas Menrath — Sun, 12 Jan 2014 20:46:04 -0000

Write-SasFile modified by Andreas Menrath

Andreas Menrath — Mon, 01 Jul 2013 20:27:17 -0000

NAME
    Write-SasFile

SYNOPSIS
    Transfers a file from your local file system to 
    a remote SAS workspace.

SYNTAX
    Write-SasFile [-Workspace] <PSObject> 
    [<CommonParameters>]

    Write-SasFile [[-From] <String>] 
    [<CommonParameters>]

    Write-SasFile [-To] <String> [<CommonParameters>]

    Write-SasFile [[-Binary] [<SwitchParameter>]] 
    [<CommonParameters>]

    Write-SasFile [[-Bulk] [<SwitchParameter>]] 
    [<CommonParameters>]

    Write-SasFile [[-ToFileRef] <PSObject>] 
    [<CommonParameters>]

DESCRIPTION

PARAMETERS
    -Workspace <PSObject>
        SAS.Workspace object

        Required?                    true
        Position?                    0
        Default value                
        Accept pipeline input?       true (ByValue)
        Accept wildcard characters?  false

    -From <String>
        file path on local file system

        Required?                    false
        Position?                    1
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -To <String>
        file path on remote file system

        Required?                    true
        Position?                    2
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -Binary [<SwitchParameter>]
        Switch if the file to be transferred is 
        binary (or text). Text files are transcoded 
        during the transfer. Binary files are copied 
        byte by byte.

        Required?                    false
        Position?                    3
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -Bulk [<SwitchParameter>]
        Switch if the file is huge and should be 
        transferred in blocks. Use this switch if 
        the remote file is larger than 20MB.

        If the option is not set then the whole file 
        is loaded into memory before it is written 
        to the local file system.

        Required?                    false
        Position?                    4
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

    -ToFileRef <PSObject>
        Use a SAS.Fileref as the remote location.
        This way you cannot only use the file system 
        on the remote SAS workspace but also the 
        wide range of SAS device types, like PIPE, 
        TEMP, DUMMY, PRINTER, ... (see SAS 
        documentation for details)

        Required?                    false
        Position?                    1
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

    <CommonParameters>
        This cmdlet supports the common parameters: 
    Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, 
    WarningVariable,
        OutBuffer and OutVariable. For more 
    information, see 
        about_CommonParameters 
    (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

    --------------  Example 1  --------------

    PS C:\> Write-SasFile $ws -from 
    "C:\local\image.gif" -to "C:\remote\image.gif" 
    -binary

    transfers an image file

    --------------  Example 2  --------------

    PS C:\> Write-SasFile $ws -from 
    "C:\local\test.log" -to "/usr/remote/test.log"

    transfers a text file. The encoding of the file 
    is transcoded during the file transfer.

    --------------  Example 3  --------------

    PS C:\> Write-SasFile $ws -from 
    "C:\local\video.avi" -to "C:\remote\video.avi" 
    -binary -bulk

    transfers a huge video file

RELATED LINKS

Recent changes to Write-SasFile

Write-SasFile modified by Andreas Menrath

Write-SasFile modified by Andreas Menrath

Write-SasFile modified by Andreas Menrath