ruby-jss 3.0.0b1 → 3.1.0b1

data/lib/jamf/api/classic/api_objects/vppable.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/web_hook.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/classic/base_classes/advanced_search.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/base_classes/api_object.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -315,7 +315,7 @@ module Jamf
           als_name = als.to_s.end_with?('s') ? "all_#{als}es" : "all_#{als}s"
 
           next if singleton_methods.include? als_name.to_sym
-          
+
           define_singleton_method als_name do |refresh = false, api: nil, cnx: Jamf.cnx|
             cnx = api if api
             send meth_name, refresh, cnx: cnx
@@ -324,7 +324,7 @@ module Jamf
 
         end # if
       end # lookup_keys.each
-      
+
       true
     end # self.define_identifier_list_methods
 
@@ -674,16 +674,16 @@ module Jamf
     # is undefined. In short - dont' use names here unless you know they are
     # unique.
     #
-    # NOTE: Integers passed in as strings, e.g. '12345' will be converted to 
+    # NOTE: Integers passed in as strings, e.g. '12345' will be converted to
     # integers and return the matching integer id if it exists.
     #
     # This means that if you have names that might match '12345' and you use
-    #    valid_id '12345' 
+    #    valid_id '12345'
     # you will get back the id 12345, if such an id exists, even if it is not
     # the object with the name '12345'
     #
     # To explicitly look for '12345' as a name, use:
-    #      valid_id name: '12345' 
+    #      valid_id name: '12345'
     #   See the ident_and_val param below.
     #
     # @param identfier [String,Integer] An identifier for an object, a value for
@@ -697,7 +697,7 @@ module Jamf
     #
     # @param ident_and_val [Hash] Do not pass in Hash.
     #   This Hash internally holds the arbitrary identifier key
-    #   and desired value when you call ".valid_id ident: 'value'", e.g. 
+    #   and desired value when you call ".valid_id ident: 'value'", e.g.
     #   ".valid_id name: 'somename'" or ".valid_id udid: some_udid"
     #   Using explicit identifier keys like this will speed things up, since
     #   the method doesn't have to search through all available identifiers
@@ -746,7 +746,7 @@ module Jamf
       if identifier.is_a?(String) && identifier.j_integer?
         int_id = identifier.to_i
         return int_id if all_ids(cnx: cnx).include? int_id
-      end 
+      end
 
       # Now go through all the other identifier keys
       keys_to_check = lookup_keys(no_aliases: true)
@@ -1142,7 +1142,7 @@ module Jamf
         raise Jamf::UnsupportedError, "Creating #{self.class::RSRC_LIST_KEY} isn't yet supported. Please use other Casper workflows."
       end
       raise ArgumentError, "Use '#{self.class}.fetch id: xx' to retrieve existing JSS objects" if args[:id]
-      
+
       args[:cnx] ||= args[:api] # deprecated
       args[:cnx] ||= Jamf.cnx
       args[:id] = :new
@@ -1568,7 +1568,7 @@ module Jamf
       raise Jamf::InvalidConnectionError, 'Not connected to MySQL' unless Jamf::DB_CNX.connected?
 
       unless defined? self.class::OBJECT_HISTORY_OBJECT_TYPE
-        raise Jamf::UnsupportedError, 
+        raise Jamf::UnsupportedError,
               "Object History access is not supported for #{self.class} objects at this time"
       end
     end

data/lib/jamf/api/classic/base_classes/configuration_profile.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/base_classes/extension_attribute.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/base_classes/group.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -351,7 +351,7 @@ module Jamf
     end
     # backward compatility
     alias set_static make_static
-        
+
     # How many members of the group?
     #
     # @return [Integer] the number of members of the group
@@ -439,7 +439,7 @@ module Jamf
       return unless id_to_remove && member_ids.include?(id_to_remove)
 
       @members.delete_if { |k, v| k == :id && v == id_to_remove }
-      @need_to_update = true 
+      @need_to_update = true
     end
 
     # Remove all members
@@ -482,7 +482,7 @@ module Jamf
     def refresh_members
       @members = @cnx.c_get(@rest_rsrc)[self.class::RSRC_OBJECT_KEY][self.class::MEMBER_CLASS::RSRC_LIST_KEY]
     end
-  
+
 
     # Public Instance Methods
     #####################################
@@ -500,7 +500,7 @@ module Jamf
 
       desired_name = self.class::MEMBER_CLASS.map_all(:id, to: :name, cnx: @cnx)[desired_id]
 
-      { name: desired_name, id: desired_id }      
+      { name: desired_name, id: desired_id }
     end
 
     # the xml formated data for adding or updating this in the JSS,

data/lib/jamf/api/classic/base_classes/patch_source.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -327,7 +327,7 @@ module Jamf
     # Init
     def initialize(**args)
       if instance_of?(Jamf::PatchSource)
-        raise Jamf::UnsupportedError, 
+        raise Jamf::UnsupportedError,
               'PatchSource is an abstract metaclass. Please use PatchInternalSource or PatchExternalSource'
       end
 

data/lib/jamf/api/classic/xml_workaround.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/connection/attributes.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/cache.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/classic_api.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/connect.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in
@@ -145,7 +145,7 @@ module Jamf
       # @option params :sticky_session [Boolean] Use a 'sticky session'? Default is false.
       #   The hostname of Jamf Cloud urls does not point to a single https server,
       #   but any node of a cluster. Those nodes often take time to see changes
-      #   made in other node. Sometimes, its important to perform a series of API 
+      #   made in other node. Sometimes, its important to perform a series of API
       #   actions to the same node, to avoid sync-timing problems between node. Setting
       #   sticky_session to true will cause all communication for this Connection to go
       #   through the one specific node it first connected ith.
@@ -208,11 +208,11 @@ module Jamf
       alias login connect
 
       # If a sticky_session was requested when the connection was made, and
-      # we are connected to a jamf cloud server, the token's http response 
-      # contains the cookie we need to send with every request to ensure a 
+      # we are connected to a jamf cloud server, the token's http response
+      # contains the cookie we need to send with every request to ensure a
       # stickey session.
       #################################
-      def enable_sticky_session(headers) 
+      def enable_sticky_session(headers)
         # commas separate the cookies
         raw_cookies = headers[Jamf::Connection::SET_COOKIE_HEADER].split(/\s*,\s*/)
 
@@ -227,7 +227,7 @@ module Jamf
 
           @sticky_session_cookie = "#{Jamf::Connection::STICKY_SESSION_COOKIE_NAME}=#{cookie_value}"
           jp_cnx.headers[Jamf::Connection::COOKIE_HEADER] = @sticky_session_cookie
-          c_cnx.headers[Jamf::Connection::COOKIE_HEADER] = @sticky_session_cookie 
+          c_cnx.headers[Jamf::Connection::COOKIE_HEADER] = @sticky_session_cookie
           return @sticky_session_cookie
         end
         # be sure to return nil if there was no appropriate cookie,

data/lib/jamf/api/connection/constants.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/default_connection.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/jamf_pro_api.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/connection/jamf_pro_api_error.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/connection/token.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -114,7 +114,7 @@ module Jamf
       alias pw_fallback? pw_fallback
 
       # @return [Faraday::Response] The response object from instantiating
-      #   a new Token object by creating a new token or validating a token 
+      #   a new Token object by creating a new token or validating a token
       #   string. This is not updated when refreshing a token, only when
       #   calling Token.new
       attr_reader :creation_http_response
@@ -170,7 +170,7 @@ module Jamf
       #################################
       def init_from_pw
         resp = token_connection(NEW_TOKEN_RSRC).post
-        
+
         if resp.success?
           parse_token_from_response resp
           @last_refresh = Time.now

data/lib/jamf/api/connection.rb

@@ -1,4 +1,4 @@
-### Copyright 2022 Pixar
+### Copyright 2023 Pixar
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
 ###    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/api_objects/computer_prestage.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/device_enrollment.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/inventory_preload_record.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/jp_building.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/api_objects/mobile_device_prestage.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/jamf_pro/base_classes/oapi_object.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in
@@ -350,8 +350,8 @@ module Jamf
     def initialize(data)
       @init_data = data
 
-      # creating a new one, not fetching from the API
-      creating = data.delete :creating_from_create
+      # creating a new one via ruby-jss, not fetching one from the API
+      creating = data.delete :creating_from_create if data.is_a?(Hash)
 
       if creating
         self.class::OAPI_PROPERTIES.each_key do |attr_name|
@@ -512,19 +512,24 @@ module Jamf
     #
     def parse_init_data(data)
       self.class::OAPI_PROPERTIES.each do |attr_name, attr_def|
-        unless data.key? attr_name
-          raise Jamf::InvalidDataError, "Initialization must include the key '#{attr_name}:'" if attr_def[:required]
+        if data.is_a? Hash
+          unless data.key? attr_name
+            raise Jamf::InvalidDataError, "Initialization must include the key '#{attr_name}:'" if attr_def[:required]
 
-          next
+            next
+          end
+
+          value =
+            if attr_def[:multi]
+              raw_array = data[attr_name] || []
+              raw_array.map { |v| parse_single_init_value v, attr_name, attr_def }
+            else
+              parse_single_init_value data[attr_name], attr_name, attr_def
+            end
+        else # not a Hash, this is a single-value object, so the data is the value
+          value = data
         end
 
-        value =
-          if attr_def[:multi]
-            raw_array = data[attr_name] || []
-            raw_array.map { |v| parse_single_init_value v, attr_name, attr_def }
-          else
-            parse_single_init_value data[attr_name], attr_name, attr_def
-          end
         instance_variable_set "@#{attr_name}", value
       end # OAPI_PROPERTIES.each
     end # parse_init_data(data)
@@ -567,7 +572,7 @@ module Jamf
     # @return (see parse_single_init_value)
     #
     def parse_enum_value(api_value, attr_name, attr_def)
-      Jamf::Validate.in_enum  api_value, enum: attr_def[:enum], 
+      Jamf::Validate.in_enum  api_value, enum: attr_def[:enum],
                                          msg: "#{api_value} is not in the allowed values for attribute #{attr_name}. Must be one of: #{attr_def[:enum].join ', '}"
     end
 

data/lib/jamf/api/jamf_pro/mixins/bulk_deletable.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
 #    with the following modification; you may not use this file except in

data/lib/jamf/api/jamf_pro/mixins/change_log.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -24,6 +24,7 @@
 #
 
 module Jamf
+
   # a mix-in module for Jamf::Resource subclasses.
   #
   # Many Jamf resources maintain an 'object history', available in the WebUI via
@@ -88,7 +89,6 @@ module Jamf
     HISTORY_ENTRY_OBJECT = Jamf::ChangeLogEntry
     POST_NOTE_OBJECT = Jamf::OAPISchemas::ObjectHistoryNote
 
-
     # when this module is included, also extend our Class Methods
     def self.included(includer)
       Jamf.load_msg "--> #{includer} is including Jamf::ChangeLog"
@@ -142,7 +142,7 @@ module Jamf
       #
       # @return [Array<Jamf::ChangeLogEntry>] The change log entries requested
       #
-      def change_log(id: nil, sort: nil, filter: nil,  cnx: Jamf.cnx)
+      def change_log(id: nil, sort: nil, filter: nil, cnx: Jamf.cnx)
         sort &&= Jamf::Sortable.parse_url_sort_param(sort)
         filter &&= Jamf::Filterable.parse_url_filter_param(filter)
 

data/lib/jamf/api/jamf_pro/mixins/collection_resource.rb

@@ -1,4 +1,4 @@
-# Copyright 2022 Pixar
+# Copyright 2023 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -288,6 +288,7 @@ module Jamf
       def pager(page_size: Jamf::Pager::DEFAULT_PAGE_SIZE, sort: nil, filter: nil, instantiate: false, cnx: Jamf.cnx)
         sort = Jamf::Sortable.parse_url_sort_param(sort)
         filter = filterable? ? Jamf::Filterable.parse_url_filter_param(filter) : nil
+        instantiate &&= self
 
         Jamf::Pager.new(
           page_size: page_size,

data/lib/jamf/api/jamf_pro/mixins/computer_recovery_lock.rb

@@ -0,0 +1,165 @@
+# Copyright 2023 Pixar
+#
+#    Licensed under the Apache License, Version 2.0 (the "Apache License")
+#    with the following modification; you may not use this file except in
+#    compliance with the Apache License and the following modification to it:
+#    Section 6. Trademarks. is deleted and replaced with:
+#
+#    6. Trademarks. This License does not grant permission to use the trade
+#       names, trademarks, service marks, or product names of the Licensor
+#       and its affiliates, except as required to comply with Section 4(c) of
+#       the License and to reproduce the content of the NOTICE file.
+#
+#    You may obtain a copy of the Apache License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the Apache License with the above modification is
+#    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#    KIND, either express or implied. See the Apache License for the specific
+#    language governing permissions and limitations under the Apache License.
+#
+
+# frozen_string_literal: true
+
+module Jamf
+
+  # This module should be mixed in to Jamf::Computer and Jamf::ComputerGroup
+  #
+  # It provides access to the macos-managed-software-updates JPAPI resource for
+  # managed OS update commands to managed macs running Big Sur or higher.
+  #
+  # TODO: When POSTing to api/preview/mdm/commands is no longer in Preview,
+  # implement that endpoint and then add the setting of the recovery lock
+  # to this module.
+  #
+  # See https://learn.jamf.com/bundle/technical-articles/page/Recovery_Lock_Enablement_in_macOS_Using_the_Jamf_Pro_API.html
+  #
+  module ComputerRecoveryLock
+
+    # when this module is included, also extend our Class Methods
+    def self.included(includer)
+      Jamf.load_msg "--> #{includer} is including #{self}"
+      includer.extend(ClassMethods)
+    end
+
+    # The JPAPI resource for a single computer's RecoveryLock password is
+    # Jamf::Computer::JPAPI_INVENTORY_RSRC then the computer's ID then this
+    RECOVERY_LOCK_PW_RSRC_SUFFIX = 'view-recovery-lock-password'
+
+    # Class Methods
+    #####################################
+    module ClassMethods
+
+      # when this module is included, also extend our Class Methods
+      def self.extended(extender)
+        Jamf.load_msg "--> #{extender} is extending #{self}"
+      end
+
+      # Retrieve the recovery lock password for a given computer, if one has been set.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [String, nil] The recovery lock password, or nil if none has been set.
+      #######################
+      def recovery_lock_password(computer, cnx: Jamf.cnx)
+        id = Jamf::Computer.valid_id computer
+        raise Jamf::NoSuchItemError, "No computer matches identifier '#{computer}'" unless id
+
+        cnx.jp_get("#{Jamf::Computer::JPAPI_INVENTORY_RSRC}/#{id}/#{RECOVERY_LOCK_PW_RSRC_SUFFIX}").dig :recoveryLockPassword
+
+      # if we get a 404 NOT FOUND error, this given computer has no passwd set, so just return nil
+      rescue Jamf::Connection::JamfProAPIError => e
+        raise unless e.http_status == 404
+
+        nil
+      end # def
+
+      # TODO: When Jamf::Computer is based on the JPAPI, these methods
+      # and the matching instance methods, will be moved into
+      # a more appropriate file - probably another mixin for
+      # the Computer class.
+      #############################################
+      #############################################
+
+      # Get the JPAPI inventory data for a single computer, either by section or all sections.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer
+      #
+      # @param section [String] One of the data sections listed in Jamf::OAPISchemas::ComputerSection::VALUE_OPTIONS
+      #   or 'all'. Default is 'GENERAL'
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [Jamf::OAPISchemas::ComputerInventory] The inventory data, with the requested sections populated
+      #########
+      def inventory_data(computer, section: 'GENERAL', cnx: Jamf.cnx)
+        # TODO: get this into a constant
+        all = 'ALL'
+
+        section = section.to_s.upcase
+        id = Jamf::Computer.valid_id computer
+        raise Jamf::NoSuchItemError, "No computer matches identifier '#{computer}'" unless id
+
+        data =
+          if section == all
+            cnx.jp_get "#{Jamf::Computer::JPAPI_INVENTORY_DETAIL_RSRC}/#{id}"
+          else
+            raise ArgumentError, "Unknown inventory data section '#{section}'" unless Jamf::OAPISchemas::ComputerSection::VALUE_OPTIONS.include?(section)
+
+            cnx.jp_get("#{Jamf::Computer::JPAPI_INVENTORY_RSRC}?section=#{section}&page=0&page-size=1&filter=id%3D%3D#{id}")[:results].first
+          end
+
+        Jamf::OAPISchemas::ComputerInventory.new data
+      end
+
+      # Get the MDM 'managementID' of a given computer.
+      #
+      # @param computer [Symbol, String, Integer, Array<String, Integer>] Identifier for the desired
+      #   Computer
+      #
+      # @param cnx [Jamf::Connection] The API connection to use. Defaults to Jamf.cnx
+      #
+      # @return [String, nil] The managementID or nil if not available
+      #########
+      def management_id(computer, cnx: Jamf.cnx)
+        inventory_data(computer, cnx: cnx).general.managementId
+      end
+
+    end # module ClassMethods
+
+    # Instance Methods
+    ######################################
+
+    # Get the recovery lock password for this Computer instance
+    #
+    # @see ComputerRecoveryLock::ClassMethods.recovery_lock_password
+    #########
+    def recovery_lock_password
+      self.class.recovery_lock_password @id, cnx: @cnx
+    end
+
+    # Get the JPAPI inventory data for this computer, either by section or all sections.
+    #
+    # @see ComputerRecoveryLock::ClassMethods.inventory_data
+    #########
+    def inventory_data(section: 'GENERAL')
+      self.class.inventory_data @id, section: section, cnx: @cnx
+    end
+
+    # Get the MDM 'managementID' of this computer.
+    #
+    # @see ComputerRecoveryLock::ClassMethods.management_id
+    #########
+    def management_id
+      inventory_data.general.managementId
+    end
+
+  end # module MacOSRedeployMgmtFramework
+
+end # module Jamf