Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


winrm (12) Versions 3.0.2

Installs and configures WinRM

cookbook 'winrm', '= 3.0.2', :supermarket
cookbook 'winrm', '= 3.0.2'
knife supermarket install winrm
knife supermarket download winrm
Quality 100%

WinRM Cookbook

Cookbook Version
Build Status

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 or come chat with us on the Chef Community Slack in #sous-chefs.



  • Windows 2008 R2
  • Windows 2012 / 2012 R2
  • Windows 2016


  • Chef 13.0+

Additional Requirements

  • 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 1024
  • thumbprint - Specify a certificate thumbprint to use, if nil will looks for certificate matching hostname, default nil
  • listen_http - Enable HTTP listener, default true
  • listen_https - Enable HTTPS listener, default true
  • allow_unencrypted - Wether to allow unencrypted WinRM connections, default true
  • allow_basic_auth - Enable Basic Authentication, default true
  • generate_cert - Whether to generate a cert if none is found, default true
  • add_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


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.

Dependent cookbooks

windows_firewall >= 5.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.


3.0.2 - 2021-06-01

  • resolved cookstyle error: test/smoke/default/default_test.rb:1:1 convention: Style/Encoding


  • refer to the correct certificate store for machine certs
  • return the certificate thumbprint as an object attribute, not a substring search
  • Migrate to actions

3.0.0 (2019-02-02)

  • This cookbook now requires Chef 13 or later as Chef 12 has been end of life for nearly a year
  • Rename the winrm resource to winrm_listener_config with backwards compatibility for the old name
  • Renamed the resource properties to better align with other Chef resources while providing full compatibility with the previous names

2.0.0 (2017-10-19)

  • BREAKING CHANGE, attributes no longer exist
  • Convert to custom resource
  • Update to work with newer chef versions


  • Added configurable Everyone group attribute

1.0.1 (10-16-2015)

  • Added Kitchen CI config
  • Added rubocop config
  • Added Berksfile
  • Added gitignore and chefignore filex
  • Moved Gemfile and add standard development dependencies
  • Fixed the license in the metadata to be Apache 2.0
  • Added modern Ruby releases to Travis and add rubocop and chefspec testing
  • Added retina badges to the readme and added the cookbook version badge

1.0.0 (02-14-2014)

  • Initial release of the WinRM cookbook
  • Adding support for Travis-CI and foodcritic

Collaborator Number Metric

3.0.2 passed this metric

Contributing File Metric

3.0.2 passed this metric

Foodcritic Metric

3.0.2 passed this metric

No Binaries Metric

3.0.2 passed this metric

Testing File Metric

3.0.2 passed this metric

Version Tag Metric

3.0.2 passed this metric