wincom

ansible-role-wincom

Ansible Role Name Github Actions

This role helps simplifying some basis common tasks for a windows host deployment.

Works on

  • Server 2019
  • Server 2016
  • Server 2012R2
  • Server 2012

Not tested (yet) on:

  • Server 2008R2
  • Server 2008-x64
  • Server 2008-x86

Requirements

  • python3-winrm (pywinrm) is needed for WinRM.

Role Variables

defaults/main.yml

Variable Description Default value
wincom_required_psmodule Powershell modules that should be installed. [xPSDesiredStateConfiguration, NetworkingDsc, ComputerManagementDsc]
wincom_service_delayed Services that should have delayed startup. [WinRM]
wincom_power_plan The desired settings of the windows power plan. "high performance"
wincom_dns_nics On what NIC should we update DNS. "*"
wincom_dns_server The DNS servers to configure on the NICs. [8.8.8.8, 8.8.4.4]
wincom_hostname Change the hostname of the system to this value. "{{ inventory_hostname }}"

Dependencies

  • WinRM on the windows host should configured for Ansible.
  • justin_p.posh5

Example Playbook

- hosts: windowshosts
  roles:
     - role: justin_p.posh5
     - role: justin_p.wincom

Local Development

This role includes a Vagrantfile that will spin up a local Windows Server 2019 VM in Virtualbox.
After creating the VM it will automatically run our role.

Development requirements

pip3 install pywinrm

Usage

  • Run vagrant up to create a VM and run our playbook
  • Run vagrant provision to reapply our playbook
  • Run vagrant destroy -f && vagrant up to recreate the VM and run our playbook.
  • Run vagrant destroy to remove the VM.

License

MIT

Authors

  • Justin Perdok (@justin-p), Orange Cyberdefense

Contributing

Feel free to open issues, contribute and submit your Pull Requests. You can also ping me on Twitter (@JustinPerdok).

About

This role helps simplifying some basis common tasks for a windows host deployment.

Install
ansible-galaxy install justin-p/ansible-role-wincom
GitHub repository
License
mit
Downloads
259
Owner
IT Geek, Ethical Hacker, DevOps Nut, PowerShell Fanatic and lover of beers :beers: