Installs and configures WinRM on a Windows System
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’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.
- Windows 2012 / 2012 R2
- Windows 2016
- Windows 2019
- Windows 2022
- Chef 15.4+
- PowerShell must already be installed
Configure winrm listeners on a host. Previously this resource was named winrm
and that legacy name will continue to function.
:create
- configure a listener
hostname
- Used for creating the listeners and finding the certificate thumbprint or creating a new one, default node['fqdn']trusted_hosts
- Trusted hosts to allow connections from, default '*'max_shell_memory
- Max memory allowed for each remote shell, default 1024thumbprint
- Specify a certificate thumbprint to use, ifnil
will looks for certificate matching hostname, default nillisten_http
- Enable HTTP listener, default truelisten_https
- Enable HTTPS listener, default trueallow_unencrypted
- Wether to allow unencrypted WinRM connections, default trueallow_basic_auth
- Enable Basic Authentication, default truegenerate_cert
- Whether to generate a cert if none is found, default trueadd_firewall_rule
- Whether to create a firewall rule which allows WinRM access, default true
winrm_listener_config 'default' do
listen_http false
allow_unencrypted false
end
This project exists thanks to all the people who contribute.
Thank you to all our backers!
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.