docs: def power_off(env, identifier, hard):
      """Power off an active virtual server."""
  
      virtual_guest = env.client['Virtual_Guest']
      vsi = SoftLayer.VSManager(env.client)
      vs_id = helpers.resolve_id(vsi.resolve_ids, identifier, 'VS')
      if not (env.skip_confirmations or
              formatting.confirm('This will power off the VS with id %s. '
                                 'Continue?' % vs_id)):
          raise exceptions.CLIAbort('Aborted.')
  
      if hard:
          virtual_guest.powerOff(id=vs_id)
      else:
          virtual_guest.powerOffSoft(id=vs_id)