Yes, the documentation is a bit sparse.
I found that 'connect device' was sufficient to swap devices if only two were connected.
If your needs are more complicated, try 'hosts'. That will give you a list of names/ids that you can try feeding to 'connect device'.
Best Answer