cookbook 'winrm', '~> 2.0.0', :supermarket
winrm (4) Versions 2.0.0 Follow6
Installs and configures WinRM
cookbook 'winrm', '~> 2.0.0'
knife cookbook site install winrm
knife cookbook site 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 failed this metric
Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.0 passed this metric
License 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
Publish Metric
2.0.0 passed this metric
Supported Platforms Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.0 passed this metric
License 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
Publish Metric
2.0.0 passed this metric
Supported Platforms Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 passed this 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
Publish Metric
2.0.0 passed this metric
Supported Platforms Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric
winrm/files/default/selfssl.exe
2.0.0 passed this metric
Supported Platforms Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 passed this metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric