cookbook 'winrm', '= 2.0.0'
winrm (12) Versions 2.0.0 Follow8
Installs and configures WinRM
cookbook 'winrm', '= 2.0.0', :supermarket
knife supermarket install winrm
knife supermarket download winrm
WinRM Cookbook
Installs and configures WinRM on a Windows System
Requirements
Platforms
- Windows 2008 R2
- Windows 2012 R2
If you would like support for your preferred platform. Please think about creating a Vagrant Box and adding test platforms
Chef
- Chef 12.7+
Known Limitations
- Does not install powershell, must be already installed.
Recipes
default
Installs and configures WinRM on the windows system. Ensures firewall rules allow traffic to WinRM.
The recipe does the following:
- Search for thumbprint for the FQDN of the node, if found use it. Otherwise create a new self signed SSL certificate if SSL is enabled.
- Install WinRM via quick configure
- Configure listeners, HTTP and/or HTTPS
- Configure additional options
- Create firewall rules
Resources
Server
winrm 'default' do Hostname # Used for creating the listeners and finding the certificate thumbprint or creating a new one, default node['fqdn'] TrustedHosts # Trusted hosts to allow connections from, default '*' MaxMemoryPerShellMB # 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 HTTP # Enable HTTP listener, default true HTTPS # Enable HTTPS listener, default true AllowUnencrypted # Wether to allow unencrypted WinRM connections, default true BasicAuth # Enable Basic Authentication, default true GenerateCert # Wether to generate a cert if none is found, default true end
Usage
The winrm::default
recipe includes the winrm resource using defaults
Create a cookbook with the winrm
resource as if you were using any other Chef resource.
For examples see the test/fixtures/cookbooks/test
directory.
License
Copyright 2014-2015, Webtrends Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Winrm Changelog
2.0.0 (2017-10-19)
- * BREAKING CHANGE, attributes no longer exist
- Convert to custom resource
- Update to work with newer chef versions
1.0.2
- 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
2.0.0 passed this metric
Contributing File Metric
2.0.0 passed this metric
Foodcritic Metric
2.0.0 passed this metric
No Binaries Metric
2.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
winrm/files/default/selfssl.exe
Testing File Metric
2.0.0 passed this metric
Version Tag Metric
2.0.0 passed this metric
2.0.0 passed this metric
2.0.0 passed this metric
Foodcritic Metric
2.0.0 passed this metric
No Binaries Metric
2.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
winrm/files/default/selfssl.exe
Testing File Metric
2.0.0 passed this metric
Version Tag Metric
2.0.0 passed this metric
2.0.0 passed this metric
2.0.0 failed this metric
Failure: Cookbook should not contain binaries. Found:
winrm/files/default/selfssl.exe
Testing File Metric
2.0.0 passed this metric
Version Tag Metric
2.0.0 passed this metric
2.0.0 passed this metric
2.0.0 passed this metric