WinRM Cookbook
Installs and configures WinRM on a Windows System
Requirements
Platform
- Windows 7 Enterprise
- Windows 2008
- Windows 2008 R2
Notes: This cookbook has been tested on the listed platforms. It may work on other platforms with or without modification.
Chef
- Chef 11+
Cookbooks
- Windows
- Powershell
Attributes
default
node['winrm']['thumbprint']- The SSL thumbprint WinRM uses for incomming connections, will be generated if not found (only used when SSL is enabled)node['winrm']['https']- Enable SSL for WinRM, default 'true'node['winrm']['http']- Enable HTTP for WinRM, defautl 'true'node['winrm']['BasicAuth']- Support basic authentication, default 'true'node['winrm']['MaxMemoryPerShellMB']- Max memory per WinRM shell allowed in MB, default '1024'node['winrm']['AllowUnencrypted']- Allow unencrypted data transfers, default 'true'node['winrm']['TrustedHosts']- Hosts that are allowed to connect via WinRM, default '*'
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
- Create SSH keys from data bag
- Create firewall rules if needed
License & Authors
- Author:: Peter Crossley peter.crossley@webtrends.com
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.