Class: Inspec::Resources::WindowsTasks

Inherits:
Object
  • Object
show all
Defined in:
lib/inspec/resources/windows_task.rb

Overview

TODO: rename singular

Instance Method Summary collapse

Constructor Details

#initialize(taskuri) ⇒ WindowsTasks

Returns a new instance of WindowsTasks.



29
30
31
32
 
# File 'lib/inspec/resources/windows_task.rb', line 29

def initialize(taskuri)
  @taskuri = taskuri
  @cache = nil
end

Instance Method Details

#disabled? ⇒ Boolean

Returns:

  • (Boolean) 


45
46
47
48
 
# File 'lib/inspec/resources/windows_task.rb', line 45

def disabled?
  return false if info.nil? || info[:state].nil?
  info[:scheduled_task_state] == "Disabled" || info[:state] == "Disabled"
end

#enabled? ⇒ Boolean

rubocop:disable Style/WordArray

Returns:

  • (Boolean) 


40
41
42
43
 
# File 'lib/inspec/resources/windows_task.rb', line 40

def enabled?
  return false if info.nil? || info[:state].nil?
  ["Ready", "Running"].include?(info[:state])
end

#exists? ⇒ Boolean

Returns:

  • (Boolean) 


34
35
36
37
 
# File 'lib/inspec/resources/windows_task.rb', line 34

def exists?
  return true unless info.nil? || info[:uri].nil?
  false
end

#info ⇒ Object 



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
 
# File 'lib/inspec/resources/windows_task.rb', line 70

def info
  return @cache unless @cache.nil?
  # PowerShell v5 has Get-ScheduledTask cmdlet,
  # _using something with backward support to v3_
  # script = "Get-ScheduledTask | ? { $_.URI -eq '#{@taskuri}' } | Select-Object URI,@{N='State';E={$_.State.ToString()}} | ConvertTo-Json"

  # Using schtasks as suggested by @modille but aligning property names to match cmdlet to future proof.
  script = "schtasks /query /v /fo csv /tn '#{@taskuri}' | ConvertFrom-Csv | Select @{N='URI';E={$_.TaskName}},@{N='State';E={$_.Status.ToString()}},'Logon Mode','Last Result','Task To Run','Run As User','Scheduled Task State' | ConvertTo-Json -Compress"

  cmd = inspec.powershell(script)

  begin
    params = JSON.parse(cmd.stdout)
  rescue JSON::ParserError => _e
    return nil
  end

  @cache = {
    uri: params["URI"],
    state: params["State"],
    logon_mode: params["Logon Mode"],
    last_result: params["Last Result"],
    task_to_run: params["Task To Run"],
    run_as_user: params["Run As User"],
    scheduled_task_state: params["Scheduled Task State"],
    type: "windows-task",
  }
end

#last_result ⇒ Object 



54
55
56
 
# File 'lib/inspec/resources/windows_task.rb', line 54

def last_result
  info[:last_result]
end

#logon_mode ⇒ Object 



50
51
52
 
# File 'lib/inspec/resources/windows_task.rb', line 50

def logon_mode
  info[:logon_mode]
end

#run_as_user ⇒ Object 



62
63
64
 
# File 'lib/inspec/resources/windows_task.rb', line 62

def run_as_user
  info[:run_as_user]
end

#task_to_run ⇒ Object 



58
59
60
 
# File 'lib/inspec/resources/windows_task.rb', line 58

def task_to_run
  info[:task_to_run].to_s.strip
end

#to_s ⇒ Object 



99
100
101
 
# File 'lib/inspec/resources/windows_task.rb', line 99

def to_s
  "Windows Task '#{@taskuri}'"
end

#type ⇒ Object 



66
67
68
 
# File 'lib/inspec/resources/windows_task.rb', line 66

def type
  info[:type] unless info.nil?
end