[owncloudcmd] Add examples (oC10, oCIS, Spaces)

[michaelstingl]

Command Line Client would be more useful with some examples:

• Typical oC10
• oCIS Personal Space
• oCIS Share Space
• oCIS other Space

Where to find the correct parameters?

---

Prerequisite:

• Run oCIS in Basic Auth
  https://doc.owncloud.com/ocis/next/deployment/services/s-list/auth-basic.html
  (not recommended! ⚠️)

oCIS improvements:

• users should be able to find the WebDAV URL in the web UI: [web] Show WebDAV Paths in web UI web#9714
• App passwords: App Passwords / Tokens for legacy WebDAV clients ocis#197

Client improvements:

• owncloudcmd with Open ID Connect client#10256

[fmoc]

Here are a few examples:

# oC 10 (both basic and OAuth2)
> testpilotcloudcmd -u admin -p admin localdir/ https://demo.owncloud.org
> testpilotcloudcmd -u admin -p admin localdir/ https://demo.owncloud.com

# oCIS (caution: plain password authentication does not work with OIDC)
> testpilotcloudcmd -u admin -p admin --server https://demo.owncloud.com localdir/ https://ocis.owncloud.com/f/166d1210-cdb9-50ab-9f1e-ecb9ef12a304$534bb038-6f9d-4093-946f-133be61fa4e7
# the remote URL that needs to be specified must be fetched from the https://ocis.owncloud.com/graph/v1.0/me/drives endpoint
# there is one "webUrl" entry per available drive
# this can be done for instance by logging into the web client and monitoring the requests made to the server
# personal space is listed by the endpoint as personal/<username>
# shares is listed as virtual/shares
# all other shares are listed as project/<spacename>

[mmattel]

We wait until web can offer an URL that can easily be used accessing the URL.
See:

• [web] Show WebDAV Paths in web UI web#9714

[michaelstingl]

Client improvements:

• owncloudcmd with Open ID Connect client#10256

Scheduled for upcoming 6.0 release