31 lines
25 KiB
JSON
31 lines
25 KiB
JSON
|
{
|
||
|
|
"name": "windows",
|
||
|
|
"description": "Provides a set of useful Windows-specific primitives.",
|
||
|
|
"long_description": "Description\n===========\n\nProvides a set of Windows-specific primitives (Chef resources) meant to aid in the creation of cookbooks/recipes targeting the Windows platform.\n\nRequirements\n============\n\nVersion 1.3.0+ of this cookbook requires Chef 0.10.10+.\n\nPlatform\n--------\n\n* Windows XP\n* Windows Vista\n* Windows Server 2003 R2\n* Windows 7\n* Windows Server 2008 (R1, R2)\n\nThe `windows_task` LWRP requires Windows Server 2008 due to its API usage.\n\nCookbooks\n---------\n\nThe following cookbooks provided by Opscode are required as noted:\n\n* chef_handler (`windows::reboot_handler` leverages the chef_handler LWRP)\n* powershell - The Printer and Printer Port LWRP require Powershell.\n\n**NOTE** We cannot specifically depend on Opscode's powershell,\n because powershell depends on this cookbook. Ensure that\n `recipe[powershell]` exists in the node's expanded run list so it\n gets downloaded where the printer LWRPs are used.\n\nAttributes\n==========\n\n* `node['windows']['allow_pending_reboots']` - used to configure the `WindowsRebootHandler` (via the `windows::reboot_handler` recipe) to act on pending reboots. default is true (ie act on pending reboots). The value of this attribute only has an effect if the `windows::reboot_handler` is in a node's run list.\n\nResource/Provider\n=================\n\nwindows\\_auto\\_run\n------------------\n\n### Actions\n\n- :create: Create an item to be run at login\n- :remove: Remove an item that was previously setup to run at login\n\n### Attribute Parameters\n\n- :name: Name attribute. The name of the value to be stored in the registry\n- :program: The program to be run at login\n- :args: The arguments for the program\n\n### Examples\n\n # Run BGInfo at login\n windows_auto_run 'BGINFO' do\n program \"C:/Sysinternals/bginfo.exe\"\n args \"\\\"C:/Sysinternals/Config.bgi\\\" /NOLICPROMPT /TIMER:0\"\n not_if { Registry.value_exists?(AUTO_RUN_KEY, 'BGINFO') }\n action :create\n end\n\n\nwindows\\_batch\n--------------\n\nExecute a batch script using the cmd.exe interpreter (much like the script resources for bash, csh, powershell, perl, python and ruby). A temporary file is created and executed like other script resources, rather than run inline. By their nature, Script resources are not idempotent, as they are completely up to the user's imagination. Use the `not_if` or `only_if` meta parameters to guard the resource for idempotence.\n\n### Actions\n\n- :run: run the batch file\n\n### Attribute Parameters\n\n- command: name attribute. Name of the command to execute.\n- code: quoted string of code to execute.\n- creates: a file this command creates - if the file exists, the command will not be run.\n- cwd: current working directory to run the command from.\n- flags: command line flags to pass to the interpreter when invoking.\n- user: A user name or user ID that we should change to before running this command.\n- group: A group name or group ID that we should change to before running this command.\n\n### Examples\n\n windows_batch \"unzip_and_move_ruby\" do\n code <<-EOH\n 7z.exe x #{Chef::Config[:file_cache_path]}/ruby-1.8.7-p352-i386-mingw32.7z -oC:\\\\source -r -y\n xcopy C:\\\\source\\\\ruby-1.8.7-p352-i386-mingw32 C:\\\\ruby /e /y\n EOH\n end\n\n windows_batch \"echo some env vars\" do\n code <<-EOH\n echo %TEMP%\n echo %SYSTEMDRIVE%\n echo %PATH%\n echo %WINDIR%\n EOH\n end\n\nwindows\\_feature\n----------------\n\nWindows Roles and Features can be thought of as built-in operating system packages that ship with the OS. A server role is a set of software programs that, when they are installed and properly configured, lets a computer perform a specific function for multiple users or other computers within a network. A Role can have multiple Role Services that provide functionality to the Role. Role services are software programs that provide the functionality of a role. Features are software programs that, although they are not directly parts of
|
||
|
|
"maintainer": "Opscode, Inc.",
|
||
|
|
"maintainer_email": "cookbooks@opscode.com",
|
||
|
|
"license": "Apache 2.0",
|
||
|
|
"platforms": {
|
||
|
|
"windows": ">= 0.0.0"
|
||
|
|
},
|
||
|
|
"dependencies": {
|
||
|
|
"chef_handler": ">= 0.0.0"
|
||
|
|
},
|
||
|
|
"recommendations": {
|
||
|
|
},
|
||
|
|
"suggestions": {
|
||
|
|
},
|
||
|
|
"conflicting": {
|
||
|
|
},
|
||
|
|
"providing": {
|
||
|
|
},
|
||
|
|
"replacing": {
|
||
|
|
},
|
||
|
|
"attributes": {
|
||
|
|
},
|
||
|
|
"groupings": {
|
||
|
|
},
|
||
|
|
"recipes": {
|
||
|
|
},
|
||
|
|
"version": "1.8.4"
|
||
|
|
}
|