Nextcloud-API Freigabelinkerstellung mit Tagübergabe

# endpoint url
$endpoint = 'https://my.nextcloud.tld'  
# credentials
$user = 'userxyz'  
$pass = 'Passw0rd'  
# filepath (here no leading backslash)
$filepath = 'Pfad1/Pfad2/test.txt'  
# tag to assign
$tagname = '7Tage'  
# =========================================
# create credential object
$creds = (new-Object PSCredential($user,(ConvertTo-SecureString $pass -AsPlainText -Force)))
# custom restmethod
function Invoke-CustomRestMethod {
    param(
        [string]$url,
        [string]$body,
        [string]$contenttype,
        [string]$method,
        [pscredential]$credentials
    )

    $data = [System.Text.Encoding]::UTF8.GetBytes($body)
    $wr = [System.Net.WebRequest]::Create($url)
    $wr.Credentials = $credentials
    if ($contenttype){
        $wr.ContentType = $contenttype
    }
    $wr.Method = $method
    if ($body){
        $rs = $wr.GetRequestStream()
        $rs.Write($data,0,$data.length)
        $rs.Flush();$rs.Close();$rs.Dispose()
    }
    $reader = [System.IO.StreamReader]::New($wr.GetResponse().GetResponseStream());
    return $reader.ReadToEnd()
}

# property request definitions
$propsfile = @'  
<?xml version="1.0"?>  
<d:propfind  xmlns:d="DAV:" xmlns:oc="http://owncloud.org/ns" xmlns:nc="http://nextcloud.org/ns">  
  <d:prop>
        <oc:fileid />
  </d:prop>
</d:propfind>
'@  
$propstag = @'  
<?xml version="1.0"?>  
<d:propfind  xmlns:d="DAV:" xmlns:oc="http://owncloud.org/ns" xmlns:nc="http://nextcloud.org/ns">  
  <d:prop>
        <oc:display-name />
        <oc:id />
  </d:prop>
</d:propfind>
'@  

# get fileid of file
$fileid = ([xml](Invoke-CustomRestMethod -url "$endpoint/remote.php/dav/files/$user/$filepath" -body $propsfile -method PROPFIND -credentials $creds -contenttype "text/xml")).multistatus.response.propstat.prop.fileid  
if (!$fileid){
    write-error -Message "ID for file '$filpath' not found."  
    return
}
# get tag id of specific tag
$tagid = ([xml](Invoke-CustomRestMethod -url "$endpoint/remote.php/dav/systemtags" -method PROPFIND -credentials $creds -body $propstag)).multistatus.response.propstat.prop | ?{$_.'display-name' -eq $tagname} | select -Expand Id  

if (!$tagid){
    write-error -Message "Tag-ID tag '$tagname' not found."  
    return
}

# if not tag is already assigned add it
if (!(([xml](Invoke-CustomRestMethod -url "$endpoint/remote.php/dav/systemtags-relations/files/$fileid" -method PROPFIND -credentials $creds -body $propstag -contenttype "text/xml")).multistatus.response.propstat.prop | ?{$_.id -eq $tagid})){  
    # assign tag
    write-host "Assigning tag '$tagname' to file '$filepath'" -F Green  
    Invoke-CustomRestMethod -url "$endpoint/remote.php/dav/systemtags-relations/files/$fileid/$tagid" -method PUT -credentials $creds  
}else{
    write-host "Tag '$tagname' is already assigned to '$filepath', no change needed." -F Gray  
}