cookbook 'windows_screenresolution', '= 0.1.0'
The windows_screenresolution cookbook has been deprecated
Author provided reason for deprecation:
The windows_screenresolution cookbook has been deprecated and is no longer being maintained by its authors. Use of the windows_screenresolution cookbook is no longer recommended.
You may find that the chocolatey cookbook is a suitable alternative.
windows_screenresolution (10) Versions 0.1.0 Follow1
Sets headless screen resolution on Windows
cookbook 'windows_screenresolution', '= 0.1.0', :supermarket
knife supermarket install windows_screenresolution
knife supermarket download windows_screenresolution
Windows Screen Resolution Cookbook
Sets headless screen resolution on Windows. It does this by creating a new user called rdp_local
that has a
startup script to RDP into the specified user account at specified screen resolution (default is 1920x1080). A
firewall rule is created to open RDP port 3389. Finally, Windows auto-logon is configured to login as rdp_local
on reboot.
Note that auto-logon requires a username and password and that the password is stored unencrypted under
windows registry HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
.
Tested on Amazon Windows Server 2012 R2 AMI.
Requirements
- Chef 11.6.0 or higher (includes a built-in registry_key resource)
- Windows Server 2008 R2 or higher due to usage of window_home
Platforms
- Windows
Cookbook Dependencies
- windows_autologin
- windows_home
Usage
Include default recipe in run list or in another cookbook to set the screen resolution.
The username
and password
must be set in order to user this cookbook.
Attributes
-
node['windows_screenresolution']['username']
- Username of account to remote login as (required). -
node['windows_screenresolution']['password']
- Password of account to remote login as (required). -
node['windows_screenresolution']['width']
- Display width in pixels. Defaults to1920
. -
node['windows_screenresolution']['height']
- Display height in pixels. Defaults to1080
. -
node['windows_screenresolution']['target']
- Identifies the computer or domain name that username and password account will be associated with for remote login. Defaults tolocalhost
. -
node['windows_screenresolution']['rdp_autologon']
- Logon as RDP user automatically on reboot. Defaults totrue
. Note that the password is stored unencrypted under windows registryHKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
. -
node['windows_screenresolution']['rdp_username']
- RDP username. Defaults tordp_local
. -
node['windows_screenresolution']['rdp_password']
- RDP password. Defaults to password of account to remote login as, ifnil
. -
node['windows_screenresolution']['rdp_domain']
- RDP domain. Defaults tonil
.
Examples
Set newuser's screen resolution to 1920x1080
(default)
node.set['windows_screenresolution']['username'] = 'newuser' node.set['windows_screenresolution']['password'] = 'N3wPassW0Rd' include_recipe 'windows_screenresolution::default'
Set newuser's screen resolution to 1366x768
node.set['windows_screenresolution']['username'] = 'newuser' node.set['windows_screenresolution']['password'] = 'N3wPassW0Rd' node.set['windows_screenresolution']['width'] = 1366 node.set['windows_screenresolution']['height'] = 768 include_recipe 'windows_screenresolution::default'
Getting Help
- Ask specific questions on Stack Overflow.
- Report bugs and discuss potential features in Github issues.
Contributing
Please refer to CONTRIBUTING.
License
MIT - see the accompanying LICENSE
file for details.
Changelog
1.0.0
- Initial release
Foodcritic Metric
0.1.0 passed this metric
0.1.0 passed this metric