Class: Inspec::Resources::WMI

Inherits:
Object
  • Object
show all
Includes:
ObjectTraverser
Defined in:
lib/resources/wmi.rb

Overview

This resource simplifies the access to wmi on CLI you would use: WMIC /NAMESPACE:\rootrsopcomputer PATH RSOP_SecuritySettingNumeric WHERE “KeyName = ‘MinimumPasswordAge’ And precedence=1” GET Setting We use Get-WmiObject via Powershell to retrieve all values.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from ObjectTraverser

#extract_value

Constructor Details

#initialize(wmiclass = nil, opts = nil) ⇒ WMI

Returns a new instance of WMI.



27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/resources/wmi.rb', line 27

def initialize(wmiclass = nil, opts = nil)
  # verify that this resource is only supported on Windows
  return skip_resource 'The `wmi` resource is not supported on your OS.' unless inspec.os.windows?

  @options = opts || {}
  # if wmiclass is not a hash, we have to handle deprecation behavior
  if wmiclass.is_a?(Hash)
    @options.merge!(wmiclass)
  else
    warn '[DEPRECATION] `wmi(\'wmiclass\')` is deprecated.  Please use `wmi({class: \'wmiclass\'})` instead.'
    @options[:class] = wmiclass
  end
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(*keys) ⇒ Object

returns nil, if not existant or value



42
43
44
45
46
47
48
49
50
51
 
# File 'lib/resources/wmi.rb', line 42

def method_missing(*keys)
  # catch behavior of rspec its implementation
  # @see https://github.com/rspec/rspec-its/blob/master/lib/rspec/its.rb#L110
  keys.shift if keys.is_a?(Array) && keys[0] == :[]

  # map all symbols to strings
  keys = keys.map { |x| x.to_s.downcase } if keys.is_a?(Array)

  value(keys)
end

Instance Attribute Details

#content ⇒ Object

Returns the value of attribute content.



25
26
27
 
# File 'lib/resources/wmi.rb', line 25

def content
  @content
end

Instance Method Details

#params ⇒ Object 



57
58
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
 
# File 'lib/resources/wmi.rb', line 57

def params
  return @content if defined?(@content)
  @content = {}

  # abort if no options are available
  return @content unless defined?(@options)

  # filter for supported options
  args = @options.select { |key, _value| [:class, :namespace, :query, :filter].include?(key) }

  # convert to Get-WmiObject arguments
  params = ''
  args.each { |key, value| params += " -#{key} \"#{value.gsub('"', '`"')}\"" }

  # run wmi command and filter empty wmi
  script = <<-EOH
  Filter Aggregate
  {
      $arr = @{}
      $_.properties | % {
          $arr.Add($_.name, $_.value)
      }
      $arr
  }
  Get-WmiObject #{params} | Aggregate | ConvertTo-Json
  EOH

  # run wmi command
  cmd = inspec.powershell(script)
  @content = JSON.parse(cmd.stdout)

  # make all keys case-insensitive
  @content = lowercase_keys(@content)
rescue JSON::ParserError => _e
  @content
end

#to_s ⇒ Object 



94
95
96
 
# File 'lib/resources/wmi.rb', line 94

def to_s
  "WMI with #{@options}"
end

#value(key) ⇒ Object 



53
54
55
 
# File 'lib/resources/wmi.rb', line 53

def value(key)
  extract_value(key, params)
end