Skip to main content
SaltStack Support

Enterprise Installation: Agentless Windows module

Download the agentless Windows module.

Requirements

  • English version of Windows
  • Windows versions:
    • Windows 7
    • Windows 8.1
    • Windows 10
    • Windows Server 2008 R2
    • Windows Server 2012 R2
    • Windows Server 2016
  • Powershell 3.0 or later
  • WinRM must be configured and running
  • The /etc/salt/roster file must have a configuration section for every Windows machine you want to connect to. The configuration must have a local admin user and password for each machine, as in the following example.
    win2012dev:  # Minion ID
      host: <IP address>
      user: <local Windows admin username>
      passwd: <password for the admin user>
      winrm: True
    

    Domain credentials are not supported.

  • Python 2 must be installed on the Salt Master. The salt-ssh module for Windows is supported only on Python 2, not later versions.
  • pip 2 must be installed.
    • CentOS 7
      $ yum install epel-release -y
      $ yum install python-pip
      $ pip install -U setuptools
      
    • Ubuntu 18.04
      $ apt-get install python-pip
      

Installing the agentless Windows module

  1. Use pip to install the whl file.

    $ pip install -U ./saltwinshell-2017.7-cp27-cp27mu-linux_x86_64.whl
    
  2. Edit /etc/salt/roster with your minion information.

    testwin:  # Minion ID
      host: <IP address>
      user: <local Windows admin username>
      passwd: <password for the admin user>
      winrm: True
    

You can now run any Salt SSH command on the Windows server, such as the following:

$ salt-ssh testwin disk.usage
  • Was this article helpful?