Cmdlets to use CMIS from Powershell and Pash

If you want to compile against Pash, make sure you add a compiled Pash version to the project. To do this, clone Pash (https://github.com/Pash-Project/Pash) and invoke update_pash.sh /path/to/cloned/Pash

Then, regardless if you are compiling it against Pash or Powershell, you need to init the git submodules via git submodule init; git submodule update.

For the tests to work, you need to add a TestConfig.config file to the project directory with the following contents:

<?xml version="1.0"?>
<configuration>
    <appSettings>
	    <add key="user" value="cmisTestUser" />
	    <add key="password" value="testUserPassword" />
	    <add key="url" value="urlToYourTestCMISRepo" />
	    <add key="repository" value="nameOfYourTestCmisRepo" />
	    <add key="repository_alt" value="nameOfYourSecondTestCmisRepo" />
	</appSettings>
</configuration>

Then build the project as usual (with your IDE, xbuild or msbuild).

The following cmdlets are provided:

First you need to import the CmisCmdlets.dll file as a module (Powershell) or PSSnapin (Pash) in your session.

To do something you first need to connect to a CMIS repository by calling

Connect-Cmis -URL 'https://youhost.com/cmis/binding' -Username 'user' -Password 'pw' -Repository 'repo'

If you want to do some advaned things, you can find the CMIS session object in $_CMIS_SESSION. To get rid of the connection, simply call

Disconnect-Cmis

You can get a list of available repositories with

Get-CmisRepository

and look for a speicfic one by passing a wildcard to the -Name parameter.

Then you can change to a specific repository with Set-CmisRepository. This cmdlet can either take the internal repository ID, or, by default, a repository name.

To make usage easier, you can operate from a specific folder, e.g. by calling

Set-CmisWorkingFolder /path/to/remotedir

From that point on, relative paths passed to any of these cmdlets will refer to that directory. With Get-CmisWorkingFolder or you can find out the current working folder.

You can get a specific CMIS object with

Get-CmisObject path/to/object

To get all objects from a folder, simply call

Get-CmisObject myfolder/

(note the slash at the end).

You can also use that cmdlet to look for a specific object recursively. For example if you want to get all Objects which names contain "test" in next 3 recursion levels, you'd need to call

Get-CmisObject -RecursionDepth 3 -Name '*test*'

Currently the creation of folders and documents is supported. To create a folder, simply use

New-CmisFolder newfolder

You can use the -Recursive flag to create a folder with all its parents.

Creating a document can be done in two ways: By using a local file and with content from the pipeline.

New-CmisDocument -Path folder/remoteFile.html -LocalFile localFile.html

This command would create a document called remoteFile.html in the existing remote folder folder with the contents of the local file localFile.html.

You can also directly create a document with contents by pipeline (or passed as the -Content parameter)

'foo','bar' | New-CmisDocument -Path output.txt -Mimetype 'text/plain'

This command would create the remote document output.txt and write each input object in it with a newline at the end. Note that for this method you explicitly need to specify the -Mimetype.

Updating an object works similar to creating a CMIS document. When dealing with a document, the usage for updating the content is the same. One important difference is that you can also directly pass the CMIS object to be updated instead of the -Path can be easier and is faster.

Also, you can rename an arbitrary CMIS object by using -Name parameter. E.g. you can also rename a folder

Update-CmisObject -Object $folder -Name 'newName'

The passed object would then get renamed to newName.

If you want to read a document, you can call

Read-CmisDocument path/to/document.txt

This call would pass pack the contents as a string to the pipeline. However, you can also download the contents to a file:

CmisDocument-CmisObject -Path path/to/document.png -Destination localFile.png

Feel free to leave out the explicit parameter names, it also works by position as Read-CmisDocument remote.txt local.txt.

You can also pass a document object instead of the path:

Read-CmisDocument -Document $doc local.txt

To remove objects, pass their paths or objects to the Remove-CmisObject cmdlet. You can also specify the -Recursive parameter to remove folders recursively (but be careful!).

Remove-CmisObject 'path/to/folderWithContents','mydoc.txt' -Recursive

Last but not least, you can query common CMIS properties, or the properties of a specific objects. Use the -Name parameter to look out for specific properties.

$cmisObj | Get-CmisProperty -Name "*time*"

A Powershell/Pash provider is in development. It's currently developed in the providerImplementation branch. First things already work. Check the tests for example usages.

Please feel free to submit request and bug reports!