Rancher cli restart host

The rancher cli reference mentions the ability to restart a host:

rancher restart


where can apparently be a host ID

How does this work when there are running containers on the host?
Does anybody have experience with this command?

I’d like to do a rolling restart of my hosts. How should a rolling host restart be done?

This is a mistake in the documentation. You cannot restart hosts via the cli. Your best bet is to coordinate that through the tools available for your cloud provider.