> For the complete documentation index, see [llms.txt](https://cgps.gitbook.io/data-flo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cgps.gitbook.io/data-flo/reference-guide/export-file-to-smb-share.md).

# export-file-to-smb-share

## Description

<mark style="color:purple;">`export-file-to-smb-share`</mark> *adaptor exports a file to a shared network drive using standard SMB/CIFS protocol.*.

## Inputs

**`file`**\
Type: `file`\
Required: Yes\
The file to be exported.

**`share address`**\
Type: `text`\
Required: Yes\
The name of the service to which you want to connect. Takes the form of `\\server\service`, `//server/service`, or `smb://server/service` where `server` is the host name or IP address of the SMB/CIFS server, and `service` is the name of the service offered by the server.

**`port`**\
Type: `number`\
Required: Yes\
The port of the SMB server. If unspecified, defaults to `445`.

**`domain`**\
Type: `text`\
Required: No\
the domain of which the user is registered. e.g. `WORKGROUP`.

**`username`**\
Type: `text`\
Required: No\
The username required to access the specified service on the server. If unspecified, defaults to `guest`.

**`password`**\
Type: `text`\
Required: No\
The password required to access the specified service on the server.

**`file path`**\
Type: `text`\
Required: Yes\
The relative path (e.g. `folder\file.txt`) or the absolute path (e.g. `\\server\service\folder\file.txt`) of the destination file.

**`overwrite`**\
Type: `boolean`\
Required: No\
Specifies whether to overwrite any existing file. If unspecified, defaults to `False`.

## Outputs

**`file`**\
Type: `file`\
The exported file.

## Examples

### Example 1: Default behaviour.

#### Inputs:

`file:` hello-world.txt

`share address:` \\\localhost\share

`port:` 8445

`domain:` *null (empty)*

`username:` username

`password:` password

`file path:` folder\hello-world.txt

`overwrite:` *null (empty)*

#### Outputs:

`file:` hello-world.txt

-> Exported the file hello-world.txt to a shared network.

## Use Cases

* Output results of workflow to a shared network drive where other agency members can access the file.
