train-winrm - Train Plugin for connecting to Windows via Remote Management
This plugin allows applications that rely on Train to communicate with the WinRM API. For example, you could use this to audit Windows Server 2016 machines.
TODO - details about underlying library
Train itself has no CLI, nor a sophisticated test harness. Chef InSpec does have such facilities, so installing Train plugins will require a Chef InSpec installation. You do not need to use or understand Chef InSpec.
Train plugins may be developed without a Chef InSpec installation.
To Install this as a User
Train plugins are distributed as gems. You may choose to manage the gem yourself, but if you are an Chef InSpec user, Chef InSpec can handle it for you.
You will need Chef InSpec v2.3 or later.
Simply run:
$ inspec plugin install train-winrm
You can then run:
TODO - example
Target Options for Train-WinRM
TODO
Reporting Issues
Bugs, typos, limitations, and frustrations are welcome to be reported through the GitHub issues page for the train-winrm project.
You may also ask questions in the #inspec channel of the Chef Community Slack team. However, for an issue to get traction, please report it as a github issue.
Development on this Plugin
Development Process
If you wish to contribute to this plugin, please use the usual fork-branch-push-PR cycle. All functional changes need new tests, and bugfixes are expected to include a new test that demonstrates the bug.
Reference Information
Plugin Development is documented on the train
project on GitHub.
Testing changes against a Windows Machine
TODO