chef 18.9.4 → 18.11.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile +16 -12
- data/README.md +0 -1
- data/Rakefile +21 -5
- data/chef-universal-mingw-ucrt.gemspec +4 -2
- data/chef.gemspec +17 -14
- data/lib/chef/application/apply.rb +1 -1
- data/lib/chef/application/base.rb +4 -4
- data/lib/chef/application/exit_code.rb +1 -1
- data/lib/chef/chef_fs/command_line.rb +4 -4
- data/lib/chef/chef_fs/file_system/chef_server/cookbook_dir.rb +1 -1
- data/lib/chef/chef_fs/file_system/chef_server/cookbooks_dir.rb +2 -3
- data/lib/chef/client.rb +2 -3
- data/lib/chef/compliance/fetcher/chef_server.rb +1 -1
- data/lib/chef/compliance/reporter/cli.rb +2 -2
- data/lib/chef/compliance/runner.rb +19 -1
- data/lib/chef/dsl/chef_vault.rb +1 -1
- data/lib/chef/dsl/rest_resource.rb +223 -16
- data/lib/chef/encrypted_data_bag_item/decryptor.rb +1 -5
- data/lib/chef/environment.rb +1 -1
- data/lib/chef/exceptions.rb +1 -1
- data/lib/chef/file_cache.rb +1 -5
- data/lib/chef/formatters/error_description.rb +8 -1
- data/lib/chef/formatters/error_inspectors/compile_error_inspector.rb +1 -1
- data/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb +1 -1
- data/lib/chef/formatters/error_inspectors/cookbook_sync_error_inspector.rb +1 -1
- data/lib/chef/group.rb +1 -1
- data/lib/chef/handler/slow_report.rb +1 -1
- data/lib/chef/http/authenticator.rb +25 -12
- data/lib/chef/mixin/api_version_request_handling.rb +1 -1
- data/lib/chef/mixin/powershell_type_coercions.rb +2 -2
- data/lib/chef/mixin/securable.rb +2 -2
- data/lib/chef/mixin/template.rb +25 -3
- data/lib/chef/mixin/versioned_api.rb +1 -1
- data/lib/chef/monkey_patches/net-http.rb +8 -8
- data/lib/chef/monkey_patches/reline-windows.rb +116 -0
- data/lib/chef/property.rb +1 -1
- data/lib/chef/provider/cron.rb +1 -1
- data/lib/chef/provider/directory.rb +11 -0
- data/lib/chef/provider/dsc_resource.rb +2 -2
- data/lib/chef/provider/file/content.rb +3 -2
- data/lib/chef/provider/file.rb +1 -1
- data/lib/chef/provider/git.rb +1 -1
- data/lib/chef/provider/ifconfig/debian.rb +1 -1
- data/lib/chef/provider/ifconfig/redhat.rb +1 -1
- data/lib/chef/provider/mount/linux.rb +1 -1
- data/lib/chef/provider/mount/windows.rb +4 -4
- data/lib/chef/provider/package/chocolatey.rb +78 -19
- data/lib/chef/provider/package/dnf/dnf_helper.py +355 -65
- data/lib/chef/provider/package/dnf/python_helper.rb +7 -4
- data/lib/chef/provider/package/dnf.rb +25 -6
- data/lib/chef/provider/package/homebrew.rb +3 -3
- data/lib/chef/provider/package/rubygems.rb +25 -2
- data/lib/chef/provider/package/snap.rb +1 -1
- data/lib/chef/provider/package/windows/exe.rb +1 -1
- data/lib/chef/provider/package/windows/msi.rb +1 -1
- data/lib/chef/provider/package/yum/rpm_utils.rb +2 -2
- data/lib/chef/provider/package/yum.rb +1 -1
- data/lib/chef/provider/powershell_script.rb +84 -84
- data/lib/chef/provider/service/debian.rb +2 -4
- data/lib/chef/provider/user/dscl.rb +1 -1
- data/lib/chef/provider/user/mac.rb +1 -1
- data/lib/chef/provider/windows_script.rb +1 -1
- data/lib/chef/resource/_rest_resource.rb +9 -7
- data/lib/chef/resource/alternatives.rb +41 -41
- data/lib/chef/resource/apt_package.rb +31 -31
- data/lib/chef/resource/apt_preference.rb +22 -22
- data/lib/chef/resource/apt_repository.rb +2 -2
- data/lib/chef/resource/archive_file.rb +52 -18
- data/lib/chef/resource/bash.rb +129 -129
- data/lib/chef/resource/bff_package.rb +15 -15
- data/lib/chef/resource/breakpoint.rb +44 -44
- data/lib/chef/resource/cab_package.rb +22 -22
- data/lib/chef/resource/chef_client_config.rb +251 -89
- data/lib/chef/resource/chef_client_cron.rb +18 -18
- data/lib/chef/resource/chef_client_launchd.rb +1 -1
- data/lib/chef/resource/chef_client_scheduled_task.rb +31 -31
- data/lib/chef/resource/chef_client_systemd_timer.rb +16 -16
- data/lib/chef/resource/chef_client_trusted_certificate.rb +28 -28
- data/lib/chef/resource/chef_handler.rb +107 -107
- data/lib/chef/resource/chef_vault_secret.rb +1 -1
- data/lib/chef/resource/chocolatey_config.rb +14 -14
- data/lib/chef/resource/chocolatey_feature.rb +1 -1
- data/lib/chef/resource/chocolatey_installer.rb +60 -42
- data/lib/chef/resource/chocolatey_package.rb +1 -1
- data/lib/chef/resource/chocolatey_source.rb +15 -15
- data/lib/chef/resource/cron/_cron_shared.rb +0 -2
- data/lib/chef/resource/cron/cron.rb +70 -70
- data/lib/chef/resource/csh.rb +5 -5
- data/lib/chef/resource/directory.rb +6 -6
- data/lib/chef/resource/dpkg_package.rb +3 -3
- data/lib/chef/resource/group.rb +28 -28
- data/lib/chef/resource/habitat/habitat_package.rb +80 -80
- data/lib/chef/resource/habitat/habitat_sup.rb +93 -95
- data/lib/chef/resource/habitat/habitat_sup_systemd.rb +10 -10
- data/lib/chef/resource/habitat/habitat_sup_windows.rb +3 -3
- data/lib/chef/resource/habitat_config.rb +13 -13
- data/lib/chef/resource/habitat_install.rb +17 -17
- data/lib/chef/resource/habitat_service.rb +1 -1
- data/lib/chef/resource/habitat_user_toml.rb +12 -12
- data/lib/chef/resource/helpers/cron_validations.rb +2 -2
- data/lib/chef/resource/homebrew_cask.rb +1 -1
- data/lib/chef/resource/homebrew_package.rb +20 -20
- data/lib/chef/resource/homebrew_tap.rb +1 -1
- data/lib/chef/resource/hostname.rb +2 -2
- data/lib/chef/resource/http_request.rb +2 -2
- data/lib/chef/resource/ifconfig.rb +34 -34
- data/lib/chef/resource/inspec_input.rb +37 -37
- data/lib/chef/resource/inspec_waiver.rb +63 -63
- data/lib/chef/resource/inspec_waiver_file_entry.rb +25 -25
- data/lib/chef/resource/ksh.rb +5 -5
- data/lib/chef/resource/launchd.rb +2 -2
- data/lib/chef/resource/link.rb +8 -8
- data/lib/chef/resource/locale.rb +6 -6
- data/lib/chef/resource/log.rb +4 -4
- data/lib/chef/resource/mdadm.rb +36 -36
- data/lib/chef/resource/mount.rb +3 -3
- data/lib/chef/resource/msu_package.rb +1 -1
- data/lib/chef/resource/ohai.rb +32 -32
- data/lib/chef/resource/ohai_hint.rb +24 -24
- data/lib/chef/resource/openssl_ec_private_key.rb +2 -2
- data/lib/chef/resource/openssl_ec_public_key.rb +2 -2
- data/lib/chef/resource/openssl_rsa_private_key.rb +1 -1
- data/lib/chef/resource/openssl_rsa_public_key.rb +2 -2
- data/lib/chef/resource/openssl_x509_certificate.rb +1 -1
- data/lib/chef/resource/openssl_x509_crl.rb +15 -15
- data/lib/chef/resource/openssl_x509_request.rb +2 -2
- data/lib/chef/resource/osx_profile.rb +54 -54
- data/lib/chef/resource/package.rb +6 -6
- data/lib/chef/resource/perl.rb +5 -5
- data/lib/chef/resource/plist.rb +4 -4
- data/lib/chef/resource/powershell_package_source.rb +12 -12
- data/lib/chef/resource/python.rb +4 -4
- data/lib/chef/resource/reboot.rb +5 -5
- data/lib/chef/resource/registry_key.rb +81 -81
- data/lib/chef/resource/remote_file.rb +72 -72
- data/lib/chef/resource/resource_notification.rb +4 -4
- data/lib/chef/resource/rhsm_errata_level.rb +1 -1
- data/lib/chef/resource/rhsm_register.rb +2 -2
- data/lib/chef/resource/scm/git.rb +79 -79
- data/lib/chef/resource/scm/subversion.rb +9 -9
- data/lib/chef/resource/script.rb +3 -3
- data/lib/chef/resource/selinux_boolean.rb +12 -12
- data/lib/chef/resource/selinux_fcontext.rb +21 -21
- data/lib/chef/resource/selinux_install.rb +18 -18
- data/lib/chef/resource/selinux_login.rb +11 -11
- data/lib/chef/resource/selinux_module.rb +16 -16
- data/lib/chef/resource/selinux_permissive.rb +9 -9
- data/lib/chef/resource/selinux_port.rb +16 -16
- data/lib/chef/resource/selinux_state.rb +28 -28
- data/lib/chef/resource/selinux_user.rb +14 -14
- data/lib/chef/resource/service.rb +5 -5
- data/lib/chef/resource/snap_package.rb +16 -16
- data/lib/chef/resource/ssh_known_hosts_entry.rb +10 -10
- data/lib/chef/resource/sudo.rb +68 -68
- data/lib/chef/resource/swap_file.rb +12 -12
- data/lib/chef/resource/sysctl.rb +42 -42
- data/lib/chef/resource/systemd_unit.rb +38 -38
- data/lib/chef/resource/timezone.rb +16 -16
- data/lib/chef/resource/user/mac_user.rb +3 -3
- data/lib/chef/resource/user.rb +6 -6
- data/lib/chef/resource/user_ulimit.rb +22 -22
- data/lib/chef/resource/windows_ad_join.rb +25 -25
- data/lib/chef/resource/windows_audit_policy.rb +34 -34
- data/lib/chef/resource/windows_auto_run.rb +8 -8
- data/lib/chef/resource/windows_certificate.rb +20 -20
- data/lib/chef/resource/windows_defender.rb +22 -22
- data/lib/chef/resource/windows_defender_exclusion.rb +17 -17
- data/lib/chef/resource/windows_env.rb +6 -6
- data/lib/chef/resource/windows_feature.rb +42 -42
- data/lib/chef/resource/windows_feature_dism.rb +8 -8
- data/lib/chef/resource/windows_feature_powershell.rb +20 -20
- data/lib/chef/resource/windows_firewall_profile.rb +28 -28
- data/lib/chef/resource/windows_firewall_rule.rb +47 -47
- data/lib/chef/resource/windows_font.rb +7 -7
- data/lib/chef/resource/windows_package.rb +59 -59
- data/lib/chef/resource/windows_pagefile.rb +29 -29
- data/lib/chef/resource/windows_path.rb +12 -12
- data/lib/chef/resource/windows_printer.rb +28 -28
- data/lib/chef/resource/windows_printer_port.rb +21 -21
- data/lib/chef/resource/windows_security_policy.rb +23 -23
- data/lib/chef/resource/windows_service.rb +108 -108
- data/lib/chef/resource/windows_share.rb +19 -19
- data/lib/chef/resource/windows_shortcut.rb +7 -7
- data/lib/chef/resource/windows_task.rb +105 -105
- data/lib/chef/resource/windows_uac.rb +14 -14
- data/lib/chef/resource/windows_update_settings.rb +27 -27
- data/lib/chef/resource/windows_user_privilege.rb +59 -59
- data/lib/chef/resource/windows_workgroup.rb +12 -12
- data/lib/chef/resource/yum_package.rb +1 -1
- data/lib/chef/resource/yum_repository.rb +36 -36
- data/lib/chef/resource.rb +1 -1
- data/lib/chef/resource_collection/resource_set.rb +2 -3
- data/lib/chef/resource_inspector.rb +1 -2
- data/lib/chef/run_context.rb +2 -2
- data/lib/chef/runner.rb +1 -1
- data/lib/chef/secret_fetcher/akeyless_vault.rb +0 -1
- data/lib/chef/secret_fetcher/hashi_vault.rb +0 -1
- data/lib/chef/shell/ext.rb +20 -20
- data/lib/chef/shell/shell_session.rb +1 -1
- data/lib/chef/shell.rb +7 -0
- data/lib/chef/version.rb +1 -1
- data/lib/chef/version_constraint.rb +1 -1
- data/lib/chef/win32/file/version_info.rb +1 -1
- metadata +63 -38
|
@@ -28,60 +28,60 @@ class Chef
|
|
|
28
28
|
description "Use the **windows_firewall_rule** resource to create, change or remove Windows firewall rules."
|
|
29
29
|
introduced "14.7"
|
|
30
30
|
examples <<~DOC
|
|
31
|
-
|
|
31
|
+
**Allowing port 80 access**:
|
|
32
32
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
33
|
+
```ruby
|
|
34
|
+
windows_firewall_rule 'IIS' do
|
|
35
|
+
local_port '80'
|
|
36
|
+
protocol 'TCP'
|
|
37
|
+
firewall_action :allow
|
|
38
|
+
end
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
**Configuring multiple remote-address ports on a rule**:
|
|
42
|
+
|
|
43
|
+
```ruby
|
|
44
|
+
windows_firewall_rule 'MyRule' do
|
|
45
|
+
description 'Testing out remote address arrays'
|
|
46
|
+
enabled false
|
|
47
|
+
local_port 1434
|
|
48
|
+
remote_address %w(10.17.3.101 172.7.7.53)
|
|
49
|
+
protocol 'TCP'
|
|
50
|
+
action :create
|
|
51
|
+
end
|
|
52
|
+
```
|
|
53
53
|
|
|
54
|
-
|
|
54
|
+
**Allow protocol ICMPv6 with ICMP Type**:
|
|
55
55
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
56
|
+
```ruby
|
|
57
|
+
windows_firewall_rule 'CoreNet-Rule' do
|
|
58
|
+
rule_name 'CoreNet-ICMP6-LR2-In'
|
|
59
|
+
display_name 'Core Networking - Multicast Listener Report v2 (ICMPv6-In)'
|
|
60
|
+
local_port 'RPC'
|
|
61
|
+
protocol 'ICMPv6'
|
|
62
|
+
icmp_type '8'
|
|
63
|
+
end
|
|
64
|
+
```
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
**Blocking WinRM over HTTP on a particular IP**:
|
|
67
67
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
68
|
+
```ruby
|
|
69
|
+
windows_firewall_rule 'Disable WinRM over HTTP' do
|
|
70
|
+
local_port '5985'
|
|
71
|
+
protocol 'TCP'
|
|
72
|
+
firewall_action :block
|
|
73
|
+
local_address '192.168.1.1'
|
|
74
|
+
end
|
|
75
|
+
```
|
|
76
76
|
|
|
77
|
-
|
|
77
|
+
**Deleting an existing rule**
|
|
78
78
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
79
|
+
```ruby
|
|
80
|
+
windows_firewall_rule 'Remove the SSH rule' do
|
|
81
|
+
rule_name 'ssh'
|
|
82
|
+
action :delete
|
|
83
|
+
end
|
|
84
|
+
```
|
|
85
85
|
DOC
|
|
86
86
|
|
|
87
87
|
property :rule_name, String,
|
|
@@ -27,13 +27,13 @@ class Chef
|
|
|
27
27
|
description "Use the **windows_font** resource to install font files on Windows. By default, the font is sourced from the cookbook using the resource, but a URI source can be specified as well."
|
|
28
28
|
introduced "14.0"
|
|
29
29
|
examples <<~DOC
|
|
30
|
-
|
|
30
|
+
**Install a font from a https source**:
|
|
31
31
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
32
|
+
```ruby
|
|
33
|
+
windows_font 'Custom.otf' do
|
|
34
|
+
source 'https://example.com/Custom.otf'
|
|
35
|
+
end
|
|
36
|
+
```
|
|
37
37
|
DOC
|
|
38
38
|
|
|
39
39
|
property :font_name, String,
|
|
@@ -106,7 +106,7 @@ class Chef
|
|
|
106
106
|
#
|
|
107
107
|
# @return [Boolean]
|
|
108
108
|
def remote_file_schema?(schema)
|
|
109
|
-
|
|
109
|
+
true if %w{http https ftp}.include?(schema)
|
|
110
110
|
end
|
|
111
111
|
|
|
112
112
|
# return new_resource.source if we have a proper URI specified
|
|
@@ -56,64 +56,64 @@ class Chef
|
|
|
56
56
|
|
|
57
57
|
introduced "11.12"
|
|
58
58
|
examples <<~DOC
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
59
|
+
**Install a package**:
|
|
60
|
+
|
|
61
|
+
```ruby
|
|
62
|
+
windows_package '7zip' do
|
|
63
|
+
action :install
|
|
64
|
+
source 'C:\\7z920.msi'
|
|
65
|
+
end
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**Specify a URL for the source attribute**:
|
|
69
|
+
|
|
70
|
+
```ruby
|
|
71
|
+
windows_package '7zip' do
|
|
72
|
+
source 'http://www.7-zip.org/a/7z938-x64.msi'
|
|
73
|
+
end
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
**Specify path and checksum**:
|
|
77
|
+
|
|
78
|
+
```ruby
|
|
79
|
+
windows_package '7zip' do
|
|
80
|
+
source 'http://www.7-zip.org/a/7z938-x64.msi'
|
|
81
|
+
checksum '7c8e873991c82ad9cfcdbdf45254ea6101e9a645e12977dcd518979e50fdedf3'
|
|
82
|
+
end
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
**Modify remote_file resource attributes**:
|
|
86
|
+
|
|
87
|
+
The windows_package resource may specify a package at a remote location using the remote_file_attributes property. This uses the remote_file resource to download the contents at the specified URL and passes in a Hash that modifies the properties of the remote_file resource.
|
|
88
|
+
|
|
89
|
+
```ruby
|
|
90
|
+
windows_package '7zip' do
|
|
91
|
+
source 'http://www.7-zip.org/a/7z938-x64.msi'
|
|
92
|
+
remote_file_attributes ({
|
|
93
|
+
:path => 'C:\\7zip.msi',
|
|
94
|
+
:checksum => '7c8e873991c82ad9cfcdbdf45254ea6101e9a645e12977dcd518979e50fdedf3'
|
|
95
|
+
})
|
|
96
|
+
end
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
**Download a nsis (Nullsoft) package resource**:
|
|
100
|
+
|
|
101
|
+
```ruby
|
|
102
|
+
windows_package 'Mercurial 3.6.1 (64-bit)' do
|
|
103
|
+
source 'https://www.mercurial-scm.org/release/windows/Mercurial-3.6.1-x64.exe'
|
|
104
|
+
checksum 'febd29578cb6736163d232708b834a2ddd119aa40abc536b2c313fc5e1b5831d'
|
|
105
|
+
end
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**Download a custom package**:
|
|
109
|
+
|
|
110
|
+
```ruby
|
|
111
|
+
windows_package 'Microsoft Visual C++ 2005 Redistributable' do
|
|
112
|
+
source 'https://download.microsoft.com/download/6/B/B/6BB661D6-A8AE-4819-B79F-236472F6070C/vcredist_x86.exe'
|
|
113
|
+
installer_type :custom
|
|
114
|
+
options '/Q'
|
|
115
|
+
end
|
|
116
|
+
```
|
|
117
117
|
DOC
|
|
118
118
|
|
|
119
119
|
allowed_actions :install, :remove
|
|
@@ -161,7 +161,7 @@ class Chef
|
|
|
161
161
|
description: "The path to a package in the local file system or the URL of a remote file that will be downloaded."
|
|
162
162
|
|
|
163
163
|
property :checksum, String,
|
|
164
|
-
desired_state: false, coerce: (proc
|
|
164
|
+
desired_state: false, coerce: (proc(&:downcase)),
|
|
165
165
|
description: "The SHA-256 checksum of the file. Use to prevent a file from being re-downloaded. When the local file matches the checksum, #{ChefUtils::Dist::Infra::PRODUCT} does not download it. Use when a URL is specified by the `source` property."
|
|
166
166
|
|
|
167
167
|
property :remote_file_attributes, Hash,
|
|
@@ -26,42 +26,42 @@ class Chef
|
|
|
26
26
|
description "Use the **windows_pagefile** resource to configure pagefile settings on Windows."
|
|
27
27
|
introduced "14.0"
|
|
28
28
|
examples <<~DOC
|
|
29
|
-
|
|
29
|
+
**Set the system to manage pagefiles**:
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
31
|
+
```ruby
|
|
32
|
+
windows_pagefile 'Enable automatic management of pagefiles' do
|
|
33
|
+
automatic_managed true
|
|
34
|
+
end
|
|
35
|
+
```
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
**Delete a pagefile**:
|
|
38
38
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
39
|
+
```ruby
|
|
40
|
+
windows_pagefile 'Delete the pagefile' do
|
|
41
|
+
path 'C'
|
|
42
|
+
action :delete
|
|
43
|
+
end
|
|
44
|
+
```
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
**Switch to system managed pagefiles**:
|
|
47
47
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
48
|
+
```ruby
|
|
49
|
+
windows_pagefile 'Change the pagefile to System Managed' do
|
|
50
|
+
path 'E:'
|
|
51
|
+
system_managed true
|
|
52
|
+
action :set
|
|
53
|
+
end
|
|
54
|
+
```
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
**Create a pagefile with an initial and maximum size**:
|
|
57
57
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
58
|
+
```ruby
|
|
59
|
+
windows_pagefile 'create the pagefile with these sizes' do
|
|
60
|
+
path 'f:'
|
|
61
|
+
initial_size 100
|
|
62
|
+
maximum_size 200
|
|
63
|
+
end
|
|
64
|
+
```
|
|
65
65
|
DOC
|
|
66
66
|
|
|
67
67
|
property :path, String,
|
|
@@ -29,21 +29,21 @@ class Chef
|
|
|
29
29
|
description "Use the **windows_path** resource to manage the path environment variable on Microsoft Windows."
|
|
30
30
|
introduced "13.4"
|
|
31
31
|
examples <<~DOC
|
|
32
|
-
|
|
32
|
+
**Add Sysinternals to the system path**:
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
34
|
+
```ruby
|
|
35
|
+
windows_path 'C:\\Sysinternals' do
|
|
36
|
+
action :add
|
|
37
|
+
end
|
|
38
|
+
```
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
**Remove 7-Zip from the system path**:
|
|
41
41
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
42
|
+
```ruby
|
|
43
|
+
windows_path 'C:\\7-Zip' do
|
|
44
|
+
action :remove
|
|
45
|
+
end
|
|
46
|
+
```
|
|
47
47
|
DOC
|
|
48
48
|
|
|
49
49
|
allowed_actions :add, :remove
|
|
@@ -35,41 +35,41 @@ class Chef
|
|
|
35
35
|
description "Use the **windows_printer** resource to setup Windows printers. This resource will automatically install the driver specified in the `driver_name` property and will automatically create a printer port using either the `ipv4_address` property or the `port_name` property."
|
|
36
36
|
introduced "14.0"
|
|
37
37
|
examples <<~DOC
|
|
38
|
-
|
|
38
|
+
**Create a printer**:
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
40
|
+
```ruby
|
|
41
|
+
windows_printer 'HP LaserJet 5th Floor' do
|
|
42
|
+
driver_name 'HP LaserJet 4100 Series PCL6'
|
|
43
|
+
ipv4_address '10.4.64.38'
|
|
44
|
+
end
|
|
45
|
+
```
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
**Delete a printer**:
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
Note: this doesn't delete the associated printer port. See windows_printer_port above for how to delete the port.
|
|
50
50
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
51
|
+
```ruby
|
|
52
|
+
windows_printer 'HP LaserJet 5th Floor' do
|
|
53
|
+
action :delete
|
|
54
|
+
end
|
|
55
|
+
```
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
**Create a printer port and a printer that uses that port (new in 17.3)**
|
|
58
58
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
59
|
+
```ruby
|
|
60
|
+
windows_printer_port '10.4.64.39' do
|
|
61
|
+
port_name 'My awesome printer port'
|
|
62
|
+
snmp_enabled true
|
|
63
|
+
port_protocol 2
|
|
64
|
+
end
|
|
65
65
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
66
|
+
windows_printer 'HP LaserJet 5th Floor' do
|
|
67
|
+
driver_name 'HP LaserJet 4100 Series PCL6'
|
|
68
|
+
port_name 'My awesome printer port'
|
|
69
|
+
ipv4_address '10.4.64.38'
|
|
70
|
+
create_port false
|
|
71
|
+
end
|
|
72
|
+
```
|
|
73
73
|
DOC
|
|
74
74
|
|
|
75
75
|
property :device_id, String,
|
|
@@ -31,32 +31,32 @@ class Chef
|
|
|
31
31
|
description "Use the **windows_printer_port** resource to create and delete TCP/IPv4 printer ports on Windows."
|
|
32
32
|
introduced "14.0"
|
|
33
33
|
examples <<~DOC
|
|
34
|
-
|
|
34
|
+
**Delete a printer port**
|
|
35
35
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
36
|
+
```ruby
|
|
37
|
+
windows_printer_port '10.4.64.37' do
|
|
38
|
+
action :delete
|
|
39
|
+
end
|
|
40
|
+
```
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
**Delete a port with a custom port_name**
|
|
43
43
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
44
|
+
```ruby
|
|
45
|
+
windows_printer_port '10.4.64.38' do
|
|
46
|
+
port_name 'My awesome port'
|
|
47
|
+
action :delete
|
|
48
|
+
end
|
|
49
|
+
```
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
**Create a port with more options**
|
|
52
52
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
53
|
+
```ruby
|
|
54
|
+
windows_printer_port '10.4.64.39' do
|
|
55
|
+
port_name 'My awesome port'
|
|
56
|
+
snmp_enabled true
|
|
57
|
+
port_protocol 2
|
|
58
|
+
end
|
|
59
|
+
```
|
|
60
60
|
DOC
|
|
61
61
|
|
|
62
62
|
property :ipv4_address, String,
|
|
@@ -51,39 +51,39 @@ class Chef
|
|
|
51
51
|
introduced "16.0"
|
|
52
52
|
|
|
53
53
|
examples <<~DOC
|
|
54
|
-
|
|
54
|
+
**Set Administrator Account to Enabled**:
|
|
55
55
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
56
|
+
```ruby
|
|
57
|
+
windows_security_policy 'EnableAdminAccount' do
|
|
58
|
+
secvalue '1'
|
|
59
|
+
action :set
|
|
60
|
+
end
|
|
61
|
+
```
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
**Rename Administrator Account**:
|
|
64
64
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
65
|
+
```ruby
|
|
66
|
+
windows_security_policy 'NewAdministratorName' do
|
|
67
|
+
secvalue 'AwesomeChefGuy'
|
|
68
|
+
action :set
|
|
69
|
+
end
|
|
70
|
+
```
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
**Set Guest Account to Disabled**:
|
|
73
73
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
74
|
+
```ruby
|
|
75
|
+
windows_security_policy 'EnableGuestAccount' do
|
|
76
|
+
secvalue '0'
|
|
77
|
+
action :set
|
|
78
|
+
end
|
|
79
|
+
```
|
|
80
80
|
DOC
|
|
81
81
|
|
|
82
82
|
property :secoption, String, name_property: true, required: true, equal_to: policy_names,
|
|
83
|
-
|
|
83
|
+
description: "The name of the policy to be set on windows platform to maintain its security."
|
|
84
84
|
|
|
85
85
|
property :secvalue, String, required: true,
|
|
86
|
-
|
|
86
|
+
description: "Policy value to be set for policy name."
|
|
87
87
|
|
|
88
88
|
load_current_value do |new_resource|
|
|
89
89
|
current_state = load_security_options
|