Public/Save-DokuAttachment.ps1

function Save-DokuAttachment {
<#
    .SYNOPSIS
        Returns the binary data of a media file
     
    .DESCRIPTION
        Returns the binary data of a media file
     
    .PARAMETER FullName
        The full name of the file to get
     
    .PARAMETER Path
        The path to save the attachment to, including filename & extension
     
    .PARAMETER Force
        Force creation of output file, overwriting any existing files with the same name
     
    .EXAMPLE
        PS C:\> Save-DokuAttachment -FullName 'value2' -Path 'value3'
     
    .OUTPUTS
        System.IO.FileInfo
     
    .NOTES
        AndyDLP - 2018-05-26
#>

    
    [CmdletBinding(PositionalBinding = $true)]
    [OutputType([System.IO.FileInfo])]
    param
    (
        [Parameter(Mandatory = $true,
                   Position = 1,
                   ValueFromPipeline = $true,
                   ValueFromPipelineByPropertyName = $true,
                   HelpMessage = 'The full name of the file to get')]
        [ValidateNotNullOrEmpty()]
        [string[]]$FullName,
        [Parameter(Mandatory = $false,
                   Position = 2,
                   HelpMessage = 'The path to save the attachment to, including filename & extension')]
        [ValidateScript({ Test-Path -Path $_ -IsValid })]
        [string]$Path,
        [Parameter(HelpMessage = 'Force creation of output file, overwriting any existing files')]
        [switch]$Force
    )

    begin {
        
    } # begin

    process {
        foreach ($AttachmentName in $FullName) {
            $APIResponse = Invoke-DokuApiCall -MethodName 'wiki.getAttachment' -MethodParameters @($AttachmentName)
            if ($APIResponse.CompletedSuccessfully -eq $true) {
                if ((Test-Path -Path $Path) -and (!$Force)) {
                    Write-Error "File with that name already exists at: $Path"
                } else {
                    Remove-Item -Path $Path -Force -ErrorAction Stop
                    $RawFileData = [string]($APIResponse.XMLPayloadResponse | Select-Xml -XPath "//value/base64").node.InnerText
                    $RawBytes = [Convert]::FromBase64String($RawFileData)
                    [IO.File]::WriteAllBytes($Path, $RawBytes) | Out-Null
                    $ItemObject = (Get-Item -Path $Path)
                    $ItemObject
                }
            } elseif ($null -eq $APIResponse.ExceptionMessage) {
                Write-Error "Fault code: $($APIResponse.FaultCode) - Fault string: $($APIResponse.FaultString)"
            } else {
                Write-Error "Exception: $($APIResponse.ExceptionMessage)"
            }
        } # foreach attachment
    } # process

    end {

    } # end
}