Rancher cli restart host

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

rancher restart

https://docs.rancher.com/rancher/v1.6/en/cli/commands/#rancher-restart-reference

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.