# Send-BluGenieItem  ### Send-BluGenieItem ### SYNOPSIS Send-BluGenieItem will copy files and folders to a new location. ### SYNTAX ``` Send-BluGenieItem [[-Source] ] [[-Destination] ] [-RelativePath ] [-Container] [-Force] [-Filter ] [-Include ] [-Exclude ] [-Recurse] [-FromSession] [-ToSession] [-ComputerName ] [-ShowProgress] [-ClearGarbageCollecting] [-Walkthrough] [-ReturnObject] [-OutUnEscapedJSON] [-OutYaml] [-FormatView ] [] ``` ### DESCRIPTION Send-BluGenieItem will copy files and folders to a new location. Copying items can be over SMB and WinRM. You can also copy items from a remote machine. ### EXAMPLES #### EXAMPLE 1 ``` Send-BluGenieItem ``` ``` This will output a Parameter Check validation error. If the * Source * Destination * ComputerName (if -ToSession is used) * ComputerName (if -FromSession is used) values are empty the command will Return an error ``` #### EXAMPLE 2 ``` Send-BluGenieItem -Source C:\Source\git.exe -Destination '\\computer1\c$\Source' -Force ``` ``` This will copy a file from the local machine to the destination computers UNC Share over SMB and force the file copy if the file already exists. ``` #### EXAMPLE 3 ``` Send-BluGenieItem -Source C:\Source\*.* -Destination C:\Source -Force -ToSession -ComputerName computer1 ``` ``` This will copy file(s) from the local machine to the destination computer over WinRM and force the file copy if the file already exists. ``` #### EXAMPLE 4 ``` Send-BluGenieItem -Source C:\Source\*.* -Destination C:\Source -ToSession -ComputerName computer1 -Recurse ``` ``` This will copy file(s) and sub-directories from the local machine to the destination computer over WinRM ``` #### EXAMPLE 5 ``` Send-BluGenieItem -Source C:\Source\*.* -Destination C:\Source -ToSession -ComputerName computer1 -Recurse -Exclude *.log ``` ``` This will copy file(s) and sub-directories from the local machine to the destination computer over WinRM excluding all *.log files. ``` #### EXAMPLE 6 ``` Send-BluGenieItem -Source C:\Source\ErrorDetails.log -Destination C:\Source\computer1 -FromSession -ComputerName computer1 -Force ``` ``` This will copy ErrorDetails.log from the local remote machine to the local computer over WinRM. If the destination path doesn't exist the directory will be created on the fly. ``` #### EXAMPLE 7 ``` Send-BluGenieItem -Source C:\Source\*.* -Destination C:\Source -Force -ToSession -ComputerName computer1 -ReturnObject ``` ``` This will copy file(s) from the local machine to the destination computer over WinRM and force the file copy if the file already exists and return just the Object content Note: The default output is a HashTable ``` #### EXAMPLE 8 ``` Send-BluGenieItem -Source C:\Source\*.* -Destination C:\Source -Force -ToSession -ComputerName computer1 -OutUnEscapedJSON ``` ``` This will copy file(s) from the local machine to the destination computer over WinRM and force the file copy if the file already exists and the return data will be in a beautified json format ``` ### PARAMETERS #### Source ``` -Source Description: The Source path to the items to want to send Notes: This can be one or more files. If your using ToSession or FromSession a sinle connection will be set to run all copies Alias: ValidateSet: Required? false Position? 1 Default value Accept pipeline input? false Accept wildcard characters? false ``` #### Destination ``` -Destination Description: The Destination path Notes: Alias: ValidateSet: Required? false Position? 2 Default value Accept pipeline input? false Accept wildcard characters? false ``` #### RelativePath ``` -RelativePath Description: RelativePath is a string path that will be placed by the Destination path while keeping the entire directory tree Notes: Alias: ValidateSet: Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` #### Container ``` -Container [] Description: Sets the Copy to a directory instead of a file Notes: Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### Force ``` -Force [] Description: Forces the file or directory creation or overwrite Notes: Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### Filter ``` -Filter Description: Filter what files you would like to Send to the destination Notes: Alias: ValidateSet: Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` #### Include ``` -Include Description: Include what files you would like to Send to the destination Notes: Alias: ValidateSet: Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` #### Exclude ``` -Exclude Description: Exclude what files you don't want to Send to the destination Notes: Alias: ValidateSet: Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` #### Recurse ``` -Recurse [] Description: Recurse through subdirectories Notes: Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### FromSession ``` -FromSession [] Description: Copy from a remote session over WinRM Notes: Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### ToSession ``` -ToSession [] Description: Copy to a remote session over WinRM Notes: Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### ComputerName ``` -ComputerName Description: Remote computer name Notes: Alias: ValidateSet: Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false ``` #### ShowProgress ``` -ShowProgress [] Description: Show Progress Bar when copying data Notes: Disabled by default Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### ClearGarbageCollecting ``` -ClearGarbageCollecting [] Description: Garbage Collection in Powershell to Speed up Scripts and help lower memory consumption Notes: This is enabled by default. To disable use -ClearGarbageCollecting:$False Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### Walkthrough ``` -Walkthrough [] Description: Start the dynamic help menu system to help walk through the current command and all of the parameters Notes: Alias: Help ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### ReturnObject ``` -ReturnObject [] Description: Return information as an Object Notes: By default the data is returned as a Hash Table Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### OutUnEscapedJSON ``` -OutUnEscapedJSON [] Description: Remove UnEsacped Char from the JSON information. Notes: This will beautify json and clean up the formatting. Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### OutYaml ``` -OutYaml [] Description: Return detailed information in Yaml Format Notes: Only supported in Posh 3.0 and above Alias: ValidateSet: Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false ``` #### FormatView ``` -FormatView Description: Automatically format the Return Object Notes: Yaml is only supported in Posh 3.0 and above Alias: ValidateSet: 'Table','Custom','CustomModified','None','JSON','OutUnEscapedJSON','CSV', 'Yaml' Required? false Position? named Default value None Accept pipeline input? false Accept wildcard characters? false ``` #### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).