# salt.modules.win_system

Support for reboot, shutdown, etc

`salt.modules.win_system.` `get_computer_desc`()

  Get the Windows computer description

  CLI Example:

      salt 'minion-id' system.get_computer_desc

`salt.modules.win_system.` `get_computer_name`()

  Get the Windows computer name

  CLI Example:

      salt 'minion-id' system.get_computer_name

`salt.modules.win_system.` `get_pending_computer_name`()

  Get a pending computer name. If the computer name has been changed, and the change is pending a system reboot, this function will return the pending computer name. Otherwise, `None` will be returned. If there was an error retrieving the pending computer name, `False` will be returned, and an error message will be logged to the minion log.

  CLI Example:

      salt 'minion-id' system.get_pending_computer_name

`salt.modules.win_system.` `get_system_date`()

  Get the Windows system date

  CLI Example:

      salt '*' system.get_system_date

`salt.modules.win_system.` `get_system_time`()

  Get the Windows system time

  CLI Example:

      salt '*' system.get_system_time

`salt.modules.win_system.` `halt`(timeout=5)

  Halt a running system

  CLI Example:

      salt '*' system.halt

`salt.modules.win_system.` `init`(runlevel)

  Change the system runlevel on sysV compatible systems

  CLI Example:

      salt '*' system.init 3

`salt.modules.win_system.` `join_domain`(domain, username, passwd, ou, acct_exists=False)

  Join a computer the an Active Directory domain

  CLI Example:

      salt 'minion-id' system.join_domain 'mydomain.local' 'myusername'              'mysecretpasswd' 'OU=MyClients;OU=MyOrg;DC=myDom;DC=local'

`salt.modules.win_system.` `poweroff`(timeout=5)

  Poweroff a running system

  CLI Example:

      salt '*' system.poweroff

`salt.modules.win_system.` `reboot`(timeout=5)

  Reboot the system

  CLI Example:

      salt '*' system.reboot

`salt.modules.win_system.` `set_computer_desc`(desc)

  Set the Windows computer description

  CLI Example:

      salt 'minion-id' system.set_computer_desc 'This computer belongs to Dave!'

`salt.modules.win_system.` `set_computer_name`(name)

  Set the Windows computer name

  CLI Example:

      salt 'minion-id' system.set_computer_name 'DavesComputer'

`salt.modules.win_system.` `set_system_date`(newdate)

  Set the Windows system date. Use <mm-dd-yy> format for the date.

  CLI Example:

      salt '*' system.set_system_date '03-28-13'

`salt.modules.win_system.` `set_system_time`(newtime)

  Set the Windows system time

  CLI Example:

      salt '*' system.set_system_time '11:31:15 AM'

`salt.modules.win_system.` `shutdown`(timeout=5)

  Shutdown a running system

  CLI Example:

      salt '*' system.shutdown

`salt.modules.win_system.` `shutdown_hard`()

  Shutdown a running system with no timeout or warning

  CLI Example:

      salt '*' system.shutdown_hard

`salt.modules.win_system.` `start_time_service`()

  Start the Windows time service

  CLI Example:

      salt '*' system.start_time_service

`salt.modules.win_system.` `stop_time_service`()

  Stop the Windows time service

  CLI Example:

      salt '*' system.stop_time_service

Current Salt release: 0.17.1

#### Previous topic

salt.modules.win_status

#### Next topic

salt.modules.win_timezone

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd