Nextcloud

1.1.0

Nextcloud.psm1

function Find-NextcloudItem {
    [OutputType([System.Xml.XmlDocument])]
    param (
        [Alias("NextcloudUrl")] [ValidateNotNullOrWhiteSpace()] [string]$url,
        [Alias("ItemPath")] [ValidateNotNullOrWhiteSpace()] [string]$path,
        [Alias("UserId")] [ValidateNotNullOrWhiteSpace()] [string]$id,
        [Alias("UserPassword")] [ValidateNotNullOrWhiteSpace()] [string]$pass,
        [Alias("OnErrorContinue")] [switch]$silent
    )
    try {
        $rest = @{
            Uri = "$($url)/remote.php/dav/files/$($id)/$($path)"
            CustomMethod = "PROPFIND"
            Authentication = "Basic"
            Credential = [pscredential]::new($id, (ConvertTo-SecureString $pass -AsPlainText -Force))
        }
        return Invoke-RestMethod @rest
    }
    catch { if ($silent) { return $null } else { throw } }
}

function Get-NextcloudItem {
    [OutputType([System.IO.FileInfo])]
    param (
        [Alias("NextcloudUrl")] [ValidateNotNullOrWhiteSpace()] [string]$url,
        [Alias("ItemPath")] [ValidateNotNullOrWhiteSpace()] [string]$path,
        [Alias("DownloadPath")] [ValidateNotNullOrWhiteSpace()] [string]$destination,
        [Alias("UserId")] [ValidateNotNullOrWhiteSpace()] [string]$id,
        [Alias("UserPassword")] [ValidateNotNullOrWhiteSpace()] [string]$pass,
        [Alias("OnErrorContinue")] [switch]$silent
    )
    try {
        $rest = @{
            Uri = "$($url)/remote.php/dav/files/$($id)/$($path)"
            Method = "Get"
            Authentication = "Basic"
            Credential = [pscredential]::new($id, (ConvertTo-SecureString $pass -AsPlainText -Force))
            OutFile = $destination
        }
        Invoke-RestMethod @rest | Out-Null
        if (Test-Path -Path $destination -PathType Leaf -ErrorAction Stop) { return Get-Item -Path $destination -ErrorAction Stop }
        else { return Get-ChildItem -Path $destination -ErrorAction Stop | Sort-Object -Property LastWriteTime, CreationTime -Descending | Select-Object -First 1 }
    }
    catch { if ($silent) { return $null } else { throw } }
}

function Set-NextcloudItem {
    [OutputType([bool])]
    param (
        [Alias("NextcloudUrl")] [ValidateNotNullOrWhiteSpace()] [string]$url,
        [Alias("ItemPath")] [ValidateNotNullOrWhiteSpace()] [string]$path,
        [Alias("UploadPath")] [ValidateNotNullOrWhiteSpace()] [string]$source,
        [Alias("UserId")] [ValidateNotNullOrWhiteSpace()] [string]$id,
        [Alias("UserPassword")] [ValidateNotNullOrWhiteSpace()] [string]$pass,
        [Alias("OnErrorContinue")] [switch]$silent
    )
    try {
        $rest = @{
            Uri = "$($url)/remote.php/dav/files/$($id)/$($path)"
            Method = "Put"
            Authentication = "Basic"
            Credential = [pscredential]::new($id, (ConvertTo-SecureString $pass -AsPlainText -Force))
            InFile = $source
        }
        Invoke-RestMethod @rest | Out-Null
        return $true
    }
    catch { if ($silent) { return $false } else { throw } }
}

function Set-NextcloudDirectory {
    [OutputType([System.Xml.XmlDocument])]
    param (
        [Alias("NextcloudUrl")] [ValidateNotNullOrWhiteSpace()] [string]$url,
        [Alias("DirectoryPath")] [ValidateNotNullOrWhiteSpace()] [string]$path,
        [Alias("UserId")] [ValidateNotNullOrWhiteSpace()] [string]$id,
        [Alias("UserPassword")] [ValidateNotNullOrWhiteSpace()] [string]$pass,
        [Alias("OnErrorContinue")] [switch]$silent
    )
    try {
        $directory = Find-NextcloudItem $url $path $id $pass -OnErrorContinue
        if (!$directory) {
            $rest = @{
                Uri = "$($url)/remote.php/dav/files/$($id)/$($path)"
                CustomMethod = "MKCOL"
                Authentication = "Basic"
                Credential = [pscredential]::new($id, (ConvertTo-SecureString $pass -AsPlainText -Force))
            }
            Invoke-RestMethod @rest | Out-Null
            $directory = Find-NextcloudItem $url $path $id $pass
        }
        return $directory
    }
    catch { if ($silent) { return $null } else { throw } }
}