salt.states.win_system¶

Management of Windows system information¶

This state is used to manage system information such as the computer name and description.

ERIK-WORKSTATION:
  system.computer_name: []

This is Erik's computer, don't touch!:
  system.computer_desc: []

salt.states.win_system.computer_desc(name)¶

Manage the computer's description field

name

The desired computer description

salt.states.win_system.computer_name(name)¶

Manage the computer's name

name

The desired computer name

salt.states.win_system.hostname(name)¶

New in version 2016.3.0.

Manage the hostname of the computer

name

The hostname to set

salt.states.win_system.join_domain(name, username=None, password=None, account_ou=None, account_exists=False, restart=False)¶

Checks if a computer is joined to the Domain. If the computer is not in the Domain, it will be joined.

name:

The name of the Domain.

username:

Username of an account which is authorized to join computers to the specified domain. Need to be either fully qualified like user@domain.tld or simply user.

password:

Password of the account to add the computer to the Domain.

account_ou:

The DN of the OU below which the account for this computer should be created when joining the domain, e.g. ou=computers,ou=departm_432,dc=my-company,dc=com.

account_exists:

Needs to be set to True to allow re-using an existing computer account.

restart:

Needs to be set to True to restart the computer after a successful join.