Skip to content
Development repository for the winrm cookbook
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.delivery
.github
files
recipes
resources
spec
test/smoke/default
.gitignore
.kitchen.appveyor.yml
.kitchen.yml
.rubocop.yml
Berksfile
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dangerfile
LICENSE
README.md
TESTING.md
appveyor.yml
chefignore
metadata.rb

README.md

WinRM Cookbook

Cookbook Version Build Status OpenCollective OpenCollective License

Installs and configures WinRM on a Windows System

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’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

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

Chef

  • Chef 13.0+

Additional Requirements

  • PowerShell must already be installed

Resources

winrm_listener_config

Configure winrm listeners on a host. Previously this resource was named winrm and that legacy name will continue to function.

Actions

  • :create - configure a listener

Properties

  • 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

Examples

winrm_listener_config 'default' do
  listen_http false
  allow_unencrypted false
end

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

https://opencollective.com/sous-chefs#backers

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

https://opencollective.com/sous-chefs/sponsor/0/website https://opencollective.com/sous-chefs/sponsor/1/website https://opencollective.com/sous-chefs/sponsor/2/website https://opencollective.com/sous-chefs/sponsor/3/website https://opencollective.com/sous-chefs/sponsor/4/website https://opencollective.com/sous-chefs/sponsor/5/website https://opencollective.com/sous-chefs/sponsor/6/website https://opencollective.com/sous-chefs/sponsor/7/website https://opencollective.com/sous-chefs/sponsor/8/website https://opencollective.com/sous-chefs/sponsor/9/website

You can’t perform that action at this time.