This module uploads a file to a target share and path. The only reason to use this module is if your existing SMB client is not able to support the features of the Metasploit Framework that you need, like pass-the-hash authentication.
To display the available options, load the module within the Metasploit console and run the commands 'show options' or 'show advanced':
msf > use auxiliary/admin/smb/upload_file
msf auxiliary(upload_file) > show actions
...actions...
msf auxiliary(upload_file) > set ACTION < action-name >
msf auxiliary(upload_file) > show options
...show and set options...
msf auxiliary(upload_file) > run
Time is precious, so I don’t want to do something manually that I can automate. Leveraging the Metasploit Framework when automating any task keeps us from having to re-create the wheel as we can use the existing libraries and focus our efforts where it matters.
– Jim O’Gorman | President, Offensive Security