Powershell Cookbook

This cookbook provides custom resources for managing legacy Windows Management Framework (WMF) installers and the supporting WinRM / DSC configuration required by older Windows platforms.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you would like to know more, visit sous-chefs.org.

Requirements

• Chef Infra Client >= 15.3
• Windows
• ms_dotnet >= 3.2.1

Resources

• powershell_wmf
• powershell_winrm
• powershell_dsc
• powershell_lcm

See LIMITATIONS.md for the supported Microsoft download matrix and lifecycle notes.

Usage

Install WMF 5.1 when the target platform needs it:

powershell_wmf '5.1'

Request a delayed reboot after installation:

powershell_wmf '4.0' do
  reboot_mode 'delayed_reboot'
  reboot_delay_mins 5
end

Prepare WinRM for DSC with an HTTPS listener:

powershell_dsc 'default' do
  enable_https_transport true
  hostname 'node.example.com'
  thumbprint 'ABCDEF1234567890'
end

Enable or disable the Local Configuration Manager:

powershell_lcm 'default'

powershell_lcm 'default' do
  action :disable
end

Testing

Local Vagrant runs use kitchen.yml. CI uses the exec driver with kitchen.exec.yml.

berks install
cookstyle
chef exec rspec --format documentation
kitchen test default-windows-2019 --destroy=always