Method: JSS::Computer.management_data

Defined in:

lib/jss/api_object/computer.rb

.management_data(ident, subset: nil, only: nil, api: JSS.api) ⇒ Hash, Array

The ‘computer management’ data for a given computer by id, looked up on the fly.

Without specifying a subset:, the entire dataset is returned as a hash of arrays, one per subset

If a subset is given then only that array is returned, and it contains hashes with data about each item (usually :name and :id)

If the only: param is provided with a subset, it is used as a hash-key to map the array to just those values, so subset: :smart_groups, only: :name will return an array of names of smartgroups that contain the computer.

Parameters:

• ident (Integer, String) —

  An identifier (id, name, serialnumber, macadress or udid) of the computer for which to retrieve Application Usage

• subset (Symbol) (defaults to: nil) —

  Fetch only a subset of data, as an array. must be one of the symbols in MGMT_DATA_SUBSETS

• only (Symbol) (defaults to: nil) —

  When fetching a subset, only return one value per item in the array. meaningless without a subset.

• api (JSS::APIConnection) (defaults to: JSS.api) —

  an API connection to use for the query. Defaults to the corrently active API. See APIConnection

Returns:

• (Hash) —

  Without a subset:, a hash of all subsets, each of which is an Array

• (Array) —

  With a subset:, an array of items in that subset, possibly limited to just certain values with only:

# File 'lib/jss/api_object/computer.rb', line 480

def self.management_data(ident, subset: nil, only: nil, api: JSS.api)
  id = valid_id ident, api: api
  raise "No computer matches identifier: #{ident}" unless id
  if subset
    management_data_subset id, subset: subset, only: only, api: api
  else
    full_management_data id, api: api
  end
end