ruby-jss 1.3.3 → 1.6.0b1

data/lib/jss/api_object/categorizable.rb

@@ -198,7 +198,7 @@ module JSS
 
       if cat.is_a? String
         @category_name = cat
-        @category_id = JSS::Category.category_id_from_name @category_name
+        @category_id = JSS::Category.category_id_from_name @category_name, api: @api
       else
         @category_name = cat[:name]
         @category_id = cat[:id]

data/lib/jss/api_object/computer.rb

@@ -1046,6 +1046,19 @@ module JSS
       @need_to_update = true
     end
 
+    # flush the logs for this computer in a given policy
+    # @see JSS::Policy.flush_logs
+    #
+    def flush_policy_logs(policy, older_than: 0, period: :days)
+      JSS::Policy.flush_logs(
+        policy,
+        older_than: older_than,
+        period: period,
+        computers: [@id],
+        api: @api
+      )
+    end
+
     def barcode1=(new_val)
       new_val = new_val.strip
       return nil if @barcode1 == new_val

data/lib/jss/api_object/configuration_profile.rb

@@ -23,7 +23,6 @@
 #
 #
 
-#
 module JSS
 
   # Classes
@@ -56,6 +55,11 @@ module JSS
     # which DISTRIBUTION_METHODS means we're in self service?
     SELF_SERVICE_DIST_METHOD = 'Make Available in Self Service'.freeze
 
+    # when a change is made, which in-scope machines should get
+    # the changed profile?
+    REDEPLOY_NEWLY_ASSIGNED = 'Newly Assigned'.freeze
+    REDEPLOY_ALL = 'All'.freeze
+
     # Our SelfService deploys profiles
     SELF_SERVICE_PAYLOAD = :profile
 
@@ -68,7 +72,6 @@ module JSS
     # How is the category stored in the API data?
     CATEGORY_DATA_TYPE = Hash
 
-
     # Attributes
     ###################################
 
@@ -78,7 +81,11 @@ module JSS
     # @return [String] the uuid of this profile. NOT Updatable
     attr_reader :uuid
 
-    # @return [Boolean] Should this profile be redeployed when an inventory update happens?
+    # @return [String] When a change is made to the profile, which scoped machines
+    #   should get the changes? This will always contain REDEPLOY_NEWLY_ASSIGNED
+    #   when fetched, but can be set to REDEPLOY_ALL via the redeploy_to_all:
+    #   parameter to #update & #save. After the update is complete, it reverts
+    #   to REDEPLOY_NEWLY_ASSIGNED
     attr_reader :redeploy_on_update
 
     # @return [String] the plist containing the payloads for this profile. NOT Updatable
@@ -116,7 +123,7 @@ module JSS
     #
     # @return [Hash] the parsed payloads plist.
     def parsed_payloads
-      Plist.parse_xml @payloads
+      JSS.parse_plist @payloads
     end
 
     # @return [Array<Hash>] the individual payloads from the payload Plist
@@ -125,12 +132,58 @@ module JSS
       parsed_payloads['PayloadContent']
     end
 
+    # @param new_content [Array<Hash>] replace the payload content entirely.
+    #
+    #   The 'payload' of a config profile is an XML Plist. The top-level key
+    #   of that plist 'PayloadContent' contains an Array of Dicts, each one being
+    #   a part of the payload for the profile.
+    #
+    #   When replacing the PayloadContent Array, using this method, provide a
+    #   *ruby* Array full of *ruby* hashes, and they will be converted to a
+    #   Plist and embedded into the API XML appropriately.
+    #
+    #   WARNING: This is experimental! Editing the Plist Payload of a Config
+    #   profile may break the profile. Make sure you test on a fake profile
+    #   before using this method in production.
+    #
+    # @return [void]
+    #
+    def payload_content=(new_content)
+      payload_plist_data = parsed_payloads
+      payload_plist_data['PayloadContent'] = new_content
+      @payloads = JSS.xml_plist_from new_content
+      @need_to_update = true
+      @update_payloads = true
+    end
+
     # @return [Array<String>] the PayloadType of each payload (e.g. com.apple.caldav.account)
     #
     def payload_types
       payload_content.map { |p| p['PayloadType'] }
     end
 
+    # clear flag after updating
+    def update(redeploy_to_all: false)
+      @redeploy_on_update = redeploy_to_all ? REDEPLOY_ALL : REDEPLOY_NEWLY_ASSIGNED
+      super()
+      # always reset to newly assigned
+      @redeploy_on_update = REDEPLOY_NEWLY_ASSIGNED
+      @update_payloads = nil
+    end
+
+    # wrapper with param
+    def save(redeploy_to_all: false)
+      if @in_jss
+        raise JSS::UnsupportedError, 'Updating this object in the JSS is currently not supported by ruby-jss' unless updatable?
+
+        update redeploy_to_all: redeploy_to_all
+      else
+        raise JSS::UnsupportedError, 'Creating this object in the JSS is currently not supported by ruby-jss' unless creatable?
+
+        create
+      end
+    end
+
     # Private Instance Methods
     ###################################
     private
@@ -142,7 +195,10 @@ module JSS
       gen = obj.add_element('general')
       gen.add_element('description').text = @description
       gen.add_element('redeploy_on_update').text = @redeploy_on_update
-
+      if @update_payloads
+        payloads_plist_xml = JSS.escape_xml(@payloads.gsub(/^\t*/, '').gsub(">\n", '>'))
+        gen.add_element('payloads').text = payloads_plist_xml
+      end
       obj << @scope.scope_xml
       add_self_service_xml doc
       add_category_to_xml doc

data/lib/jss/api_object/directory_binding_type.rb

@@ -25,66 +25,72 @@
 
 module JSS
 
-# Module for containing the different types of DirectoryBindings stored within the JSS
-module DirectoryBindingType
-
-        # Module Variables
-        #####################################
-
-        # Module Methods
-        #####################################
-        def should_update
-            @need_to_update = true
-        end
-
-        def set_type_settings(settings)
-            @type_settings = settings
-            @type_settings.container = self
-        end
-
-        # Classes
-        #####################################
-
-        # A generic binding type class that sets common variables, methods, and constructors 
-        # for all the different directory binding types.
-        #
-        # @author Tyler Morgan        
-        class DirectoryBindingType
-            # Mix-Ins
-            #####################################
-
-            # Class Methods
-            #####################################
-
-            # Class Constants
-            #####################################
-
-            # The different network protocols supported.
-            NETWORK_PROTOCOL = {
-                afp: "AFP",
-                smb: "SMB"
-            }.freeze
-
-
-            # The different home folder types.
-            HOME_FOLDER_TYPE = {
-                network: "Network",
-                local: "Local",
-                either: "Either",
-                mobile: "Mobile"
-            }.freeze
-
-            # Attributes
-            #####################################
-
-            # This is used to properly handle updating the containing object.
-            attr_accessor :container
-        end
+  # Module for containing the different types of DirectoryBindings stored within the JSS
+  module DirectoryBindingType
+
+    # Module Variables
+    #####################################
+
+    # Module Methods
+    #####################################
+    def should_update
+      @need_to_update = true
+    end
+
+    def set_type_settings(settings)
+      @type_settings = settings
+      @type_settings.container = self
+    end
+
+    # Classes
+    #####################################
+
+    # A generic binding type class that sets common variables, methods, and constructors
+    # for all the different directory binding types.
+    #
+    # @author Tyler Morgan
+    class DirectoryBindingType
+
+
+      # Mix-Ins
+      #####################################
+
+      # Class Methods
+      #####################################
+
+      # Class Constants
+      #####################################
+
+      # The different network protocols supported.
+      NETWORK_PROTOCOL = {
+        afp: 'AFP',
+        smb: 'SMB'
+      }.freeze
+
+      # The different home folder types.
+      HOME_FOLDER_TYPE = {
+        network: 'Network',
+        local: 'Local',
+        either: 'Either',
+        mobile: 'Mobile'
+      }.freeze
+
+      # Attributes
+      #####################################
+
+      # This is used to properly handle updating the containing object.
+      attr_accessor :container
+
+
+  end
+
+
     end
+
 end
 
-require "jss/api_object/directory_binding_type/active_directory"
-require "jss/api_object/directory_binding_type/open_directory"
-require "jss/api_object/directory_binding_type/admitmac"
-require "jss/api_object/directory_binding_type/centrify"
-require "jss/api_object/directory_binding_type/powerbroker_identity_services"
+require 'jss/api_object/directory_binding_type/active_directory'
+require 'jss/api_object/directory_binding_type/open_directory'
+require 'jss/api_object/directory_binding_type/admitmac'
+require 'jss/api_object/directory_binding_type/centrify'
+require 'jss/api_object/directory_binding_type/powerbroker_identity_services'

data/lib/jss/api_object/directory_binding_type/active_directory.rb

@@ -259,11 +259,17 @@ module JSS
             # @return [void]
             def default_shell=(newvalue)
 
-                # Data Check
-                raise JSS::InvalidDataError, "default_shell must be a string." unless newvalue.is_a? String
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "default_shell must be a string." unless newvalue.is_a? String
+                        newvalue
+                    end
 
                 # Update Value
-                @default_shell = newvalue
+                @default_shell = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update
@@ -280,12 +286,17 @@ module JSS
             #
             # @return [void]
             def uid=(newvalue)
-
-                # Data Check
-                raise JSS::InvalidDataError, "uid must be either an integer or a string." unless (newvalue.is_a? Integer || newvalue.is_a?(String))
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "uid must be either an integer or a string." unless (newvalue.is_a? Integer || newvalue.is_a?(String))
+                        newvalue
+                    end
 
                 # Update Value
-                @uid = newvalue
+                @uid = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update
@@ -302,12 +313,17 @@ module JSS
             #
             # @return [void]
             def forest=(newvalue)
-
-                # Data Check
-                raise JSS::InvalidDataError, "forest must be a string." unless newvalue.is_a? String
-
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "forest must be a string." unless newvalue.is_a? String
+                        newvalue
+                    end
+                
                 # Update Value
-                @forest = newvalue
+                @forest = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update
@@ -323,12 +339,17 @@ module JSS
             #
             # @return [void]
             def user_gid=(newvalue)
-
-                # Data Check
-                raise JSS::InvalidDataError, "user_gid must be either an integer or a string." unless (newvalue.is_a? Integer || newvalue.is_a?(String))
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "user_gid must be either an integer or a string." unless (newvalue.is_a? Integer || newvalue.is_a?(String))
+                        newvalue
+                    end
 
                 # Update Value
-                @user_gid = newvalue
+                @user_gid = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update
@@ -345,12 +366,17 @@ module JSS
             #
             # @return [void]
             def gid=(newvalue)
-
-                # Data Check
-                raise JSS::InvalidDataError, "gid must be either an integer or a string." unless (newvalue.is_a? Integer || newvalue.is_a?(String))
-
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "gid must be either an integer or a string." unless (newvalue.is_a? Integer || newvalue.is_a?(String))
+                        newvalue
+                    end
+                
                 # Update Value
-                @gid = newvalue
+                @gid = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update
@@ -389,12 +415,17 @@ module JSS
             #
             # @return [void]
             def preferred_domain=(newvalue)
-
-                # Data Check
-                raise JSS::InvalidDataError, "preferred_domain must be a string." unless newvalue.is_a? String
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "preferred_domain must be a string." unless newvalue.is_a? String
+                        newvalue
+                    end
 
                 # Update Value
-                @preferred_domain = newvalue
+                @preferred_domain = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update
@@ -411,16 +442,22 @@ module JSS
             #
             # @return [void]
             def admin_groups=(newvalue)
-
-                # Data Check
-                raise JSS::InvalidDataError, "admin_groups must be either a string or an array of strings." unless (newvalue.is_a? String || newvalue.is_a?(Array))
-
+                new =
+                    if newvalue.to_s.empty?
+                        JSS::BLANK
+                    else
+                        # Data Check
+                        raise JSS::InvalidDataError, "admin_groups must be either a string or an array of strings." unless (newvalue.is_a? String || newvalue.is_a?(Array))
+                        
+                        if newvalue.is_a? Array
+                            newvalue.join ","
+                        else
+                            newvalue
+                        end
+                    end
+                    
                 # Update Value
-                if newvalue.is_a? Array
-                    @admin_groups = newvalue.join ","
-                else
-                    @admin_groups = newvalue
-                end
+                @admin_groups = new
 
                 # Set the object to needing to be updated.
                 self.container&.should_update

data/lib/jss/api_object/directory_binding_type/admitmac.rb

@@ -24,502 +24,571 @@
 ###
 
 module JSS
-    
-    # Module for containing the different types of DirectoryBindings stored within the JSS
-    
-    module DirectoryBindingType
-
-        # Module Variables
-        #####################################
-
-        # Module Methods
-        #####################################
-
-        # Classes
-        #####################################
-
-        # Class for the specific ADmitMac DirectoryBinding type stored within the JSS
-        # 
-        # @author Tyler Morgan
-        #
-        # @note "Map Home Directory To Attribute" is currently only available in the Jamf Pro UI not through the API.
-        #
-        # Attributes
-        # @!attribute [rw] require_confirmation
-        # @!attribute [rw] local_home
-        # @!attribute [rw] mount_style
-        # @!attribute [rw] default_shell
-        # @!attribute [rw] mount_network_home
-        # @!attribute [rw] place_home_folders
-        # @!attribute [rw] uid
-        # @!attribute [rw] user_gid
-        # @!attribute [rw] gid
-        # @!attribute [rw] admin_group
-        # @!attribute [rw] cached_credentials
-        # @!attribute [rw] add_user_to_local
-        # @!attribute [rw] users_ou
-        # @!attribute [rw] groups_ou
-        # @!attribute [rw] printers_ou
-        # @!attribute [rw] shared_folders_ou
-        # TODO: Include default values upon creation
-
-        class ADmitMac < DirectoryBindingType
-            # Mix-Ins
-            #####################################
-
-            # Class Methods
-            #####################################
-
-            # Class Constants
-            #####################################
-
-            # Attributes
-            #####################################
-
-            attr_reader :require_confirmation
-            attr_reader :local_home
-            attr_reader :mount_style
-            attr_reader :default_shell
-            attr_reader :mount_network_home
-            attr_reader :place_home_folders
-            attr_reader :uid
-            attr_reader :user_gid
-            attr_reader :gid
-            attr_reader :admin_group
-            attr_reader :cached_credentials
-            attr_reader :add_user_to_local
-            attr_reader :users_ou
-            attr_reader :groups_ou
-            attr_reader :printers_ou
-            attr_reader :shared_folders_ou
-
-            # Constructor
-            #####################################
-
-            # An initializer for the ADmitMac object.
-            # 
-            # @author Tyler Morgan
-            # @see JSS::DirectoryBinding
-            # @see JSS::DirectoryBindingType
-            #
-            # @note Due to a JSS API funk, mount_style is not able to be configured through the API. It is linked to place_home_folders
-            #
-            # @param [Hash] initialize data
-            def initialize(init_data)
-
-                # Return without processing anything since there is
-                # nothing to process.
-                return if init_data.nil?
-
-                # Process the provided information
-                @require_confirmation = init_data[:require_confirmation]
-                @default_shell = init_data[:default_shell]
-                @mount_network_home = init_data[:mount_network_home]
-                @place_home_folders = init_data[:place_home_folders]
-                @uid = init_data[:uid]
-                @user_gid = init_data[:user_gid]
-                @gid = init_data[:gid]
-                @cached_credentials = init_data[:cached_credentials]
-                @add_user_to_local = init_data[:add_user_to_local]
-                @users_ou = init_data[:users_ou]
-                @groups_ou = init_data[:groups_ou]
-                @printers_ou = init_data[:printers_ou]
-                @shared_folders_ou = init_data[:shared_folders_ou]
-                @mount_style = init_data[:mount_style]
-
-                if init_data[:local_home].nil? || init_data[:local_home].is_a?(String)
-                    raise JSS::InvalidDataError, "Local Home must be one of #{HOME_FOLDER_TYPE.values.join(', ')}." unless HOME_FOLDER_TYPE.values.include? init_data[:local_home] || init_data[:local_home].nil?
-
-                    @local_home = init_data[:local_home]
-                else
-                    raise JSS::InvalidDataError, "Local Home must be one of :#{HOME_FOLDER_TYPE.keys.join(',:')}." unless HOME_FOLDER_TYPE.keys.include? init_data[:local_home]
-                end
-
-                if init_data[:admin_group].nil?
-                    # This is needed since we have the ability to add and
-                    # remove admin groups from this array.
-                    @admin_group = []
-                elsif init_data[:admin_group].is_a? String
-                    @admin_group = init_data[:admin_group].split(',')
-                else
-                    @admin_group = init_data[:admin_group]
-                end
-            end
-
-                
-
-            # Public Instance Methods
-            #####################################
-
-            # Require confirmation before creating a mobile account on the system.
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [Bool]
-            #
-            # @raise [JSS::InvalidDataError] If the new value doesn't match a Bool value
-            #
-            # @return [void]
-            def require_confirmation=(newvalue)
-
-                raise JSS::InvalidDataError, "require_confirmation must be true or false." unless newvalue.is_a? Bool
-
-                @require_confirmation = newvalue
-                
-                self.container&.should_update
-            end
-
-
-            # The type of home directory type created upon logging into a system
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [Symbol] The key specific to the folder type you want in HOME_FOLDER_TYPE
-            # @see JSS::DirectoryBindingType::HOME_FOLDER_TYPE
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not one of the possible keys in HOME_FOLDER_TYPE
-            #
-            # @return [void]
-            def local_home=(newvalue)
-                
-                raise JSS::InvalidDataError, "local_home must be one of :#{HOME_FOLDER_TYPE.keys.join(',:')}." unless HOME_FOLDER_TYPE.keys.include? newvalue
-
-                @local_home = HOME_FOLDER_TYPE[newvalue]
-                
-                self.container&.should_update
-            end
-
-            # The default shell assigned first upon logging into a system
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The string path of the shell file being set as the default
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def default_shell=(newvalue)
-
-                raise JSS::InvalidDataError, "default_shell must be empty or a string." unless newvalue.is_a?(String)
-
-                @default_shell = newvalue
-                
-                self.container&.should_update
-            end
 
-
-            # Mount network home folder on desktop
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [Bool]
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a Bool
-            #
-            # @return [void]
-            def mount_network_home=(newvalue)
-
-                raise JSS::InvalidDataError, "mount_network_home must be true or false." unless newvalue.is_a? Bool
-
-                @mount_network_home = newvalue
-                
-                self.container&.should_update
+  # Module for containing the different types of DirectoryBindings stored within the JSS
+
+  module DirectoryBindingType
+
+    # Module Variables
+    #####################################
+
+    # Module Methods
+    #####################################
+
+    # Classes
+    #####################################
+
+    # Class for the specific ADmitMac DirectoryBinding type stored within the JSS
+    #
+    # @author Tyler Morgan
+    #
+    # @note "Map Home Directory To Attribute" is currently only available in the Jamf Pro UI not through the API.
+    #
+    # Attributes
+    # @!attribute [rw] require_confirmation
+    # @!attribute [rw] local_home
+    # @!attribute [rw] mount_style
+    # @!attribute [rw] default_shell
+    # @!attribute [rw] mount_network_home
+    # @!attribute [rw] place_home_folders
+    # @!attribute [rw] uid
+    # @!attribute [rw] user_gid
+    # @!attribute [rw] gid
+    # @!attribute [rw] admin_group
+    # @!attribute [rw] cached_credentials
+    # @!attribute [rw] add_user_to_local
+    # @!attribute [rw] users_ou
+    # @!attribute [rw] groups_ou
+    # @!attribute [rw] printers_ou
+    # @!attribute [rw] shared_folders_ou
+    # TODO: Include default values upon creation
+    class ADmitMac < DirectoryBindingType
+
+      # Mix-Ins
+      #####################################
+
+      # Class Methods
+      #####################################
+
+      # Class Constants
+      #####################################
+
+      # Attributes
+      #####################################
+
+      attr_reader :require_confirmation
+      attr_reader :local_home
+      attr_reader :mount_style
+      attr_reader :default_shell
+      attr_reader :mount_network_home
+      attr_reader :place_home_folders
+      attr_reader :uid
+      attr_reader :user_gid
+      attr_reader :gid
+      attr_reader :admin_group
+      attr_reader :cached_credentials
+      attr_reader :add_user_to_local
+      attr_reader :users_ou
+      attr_reader :groups_ou
+      attr_reader :printers_ou
+      attr_reader :shared_folders_ou
+
+      # Constructor
+      #####################################
+
+      # An initializer for the ADmitMac object.
+      #
+      # @author Tyler Morgan
+      # @see JSS::DirectoryBinding
+      # @see JSS::DirectoryBindingType
+      #
+      # @note Due to a JSS API funk, mount_style is not able to be configured through the API. It is linked to place_home_folders
+      #
+      # @param [Hash] initialize data
+      def initialize(init_data)
+        # Return without processing anything since there is
+        # nothing to process.
+        return if init_data.nil?
+
+        # Process the provided information
+        @require_confirmation = init_data[:require_confirmation]
+        @default_shell = init_data[:default_shell]
+        @mount_network_home = init_data[:mount_network_home]
+        @place_home_folders = init_data[:place_home_folders]
+        @uid = init_data[:uid]
+        @user_gid = init_data[:user_gid]
+        @gid = init_data[:gid]
+        @cached_credentials = init_data[:cached_credentials]
+        @add_user_to_local = init_data[:add_user_to_local]
+        @users_ou = init_data[:users_ou]
+        @groups_ou = init_data[:groups_ou]
+        @printers_ou = init_data[:printers_ou]
+        @shared_folders_ou = init_data[:shared_folders_ou]
+        @mount_style = init_data[:mount_style]
+
+        if init_data[:local_home].nil? || init_data[:local_home].is_a?(String)
+          unless HOME_FOLDER_TYPE.values.include? init_data[:local_home] || init_data[:local_home].nil?
+            raise JSS::InvalidDataError, "Local Home must be one of #{HOME_FOLDER_TYPE.values.join(', ')}."
             end
 
-            # Path at which home folders are placed
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The string path of the folder which user's directory files and folders will be created
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def place_home_folders=(newvalue)
-
-                raise JSS::InvalidDataError, "place_home_folders must be a string." unless newvalue.is_a? String
-
-                @place_home_folders = newvalue
-                
-                self.container&.should_update
+          @local_home = init_data[:local_home]
+        else
+          unless HOME_FOLDER_TYPE.keys.include? init_data[:local_home]
+            raise JSS::InvalidDataError, "Local Home must be one of :#{HOME_FOLDER_TYPE.keys.join(',:')}."
             end
+        end
 
-            # Jamf has these linked for some reason...
-            alias mount_style place_home_folders
-
-
-            # Map specific UID to Attribute
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The UID you want to be mapped
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def uid=(newvalue)
-
-                raise JSS::InvalidDataError, "uid must be a string, integer, or nil." unless newvalue.is_a?(String) || newvalue.is_a?(Integer) || newvalue.nil?
-
-                @uid = newvalue
-                
-                self.container&.should_update
+        @admin_group = if init_data[:admin_group].nil?
+                         # This is needed since we have the ability to add and
+                         # remove admin groups from this array.
+                         []
+                       elsif init_data[:admin_group].is_a? String
+                         init_data[:admin_group].split(',')
+                       else
+                         init_data[:admin_group]
+                       end
+      end
+
+      # Public Instance Methods
+      #####################################
+
+      # Require confirmation before creating a mobile account on the system.
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [Bool]
+      #
+      # @raise [JSS::InvalidDataError] If the new value doesn't match a Bool value
+      #
+      # @return [void]
+      def require_confirmation=(newvalue)
+        raise JSS::InvalidDataError, 'require_confirmation must be true or false.' unless newvalue.is_a?(TrueClass) || newvalue.is_a(FalseClass)
+
+        @require_confirmation = newvalue
+
+        container&.should_update
+      end
+
+      # The type of home directory type created upon logging into a system
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [Symbol] The key specific to the folder type you want in HOME_FOLDER_TYPE
+      # @see JSS::DirectoryBindingType::HOME_FOLDER_TYPE
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not one of the possible keys in HOME_FOLDER_TYPE
+      #
+      # @return [void]
+      def local_home=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, "local_home must be one of :#{HOME_FOLDER_TYPE.keys.join(',:')}." unless HOME_FOLDER_TYPE.keys.include? newvalue
+
+            HOME_FOLDER_TYPE[newvalue]
             end
 
-            
-            # Map specific a User's GID to Attribute
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The User's GID you want to be mapped
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def user_gid=(newvalue)
-
-                raise JSS::InvalidDataError, "user_gid must be a string, integer, or nil." unless newvalue.is_a?(String) || newvalue.is_a?(Integer) || newvalue.nil?
-
-                @user_gid = newvalue
-                
-                self.container&.should_update
+        @local_home = new
+
+        container&.should_update
+      end
+
+      # The default shell assigned first upon logging into a system
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The string path of the shell file being set as the default
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def default_shell=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'default_shell must be empty or a string.' unless newvalue.is_a?(String)
+
+            newvalue
             end
 
-
-            # Map specific GID to Attribute
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The GID you want to be mapped
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def gid=(newvalue)
-
-                raise JSS::InvalidDataError, "gid must be a string, integer, or nil." unless newvalue.is_a?(String) || newvalue.is_a?(Integer) || newvalue.nil?
-
-                @gid = newvalue
-                
-                self.container&.should_update
+        @default_shell = new
+
+        container&.should_update
+      end
+
+      # Mount network home folder on desktop
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [Bool]
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a Bool
+      #
+      # @return [void]
+      def mount_network_home=(newvalue)
+        raise JSS::InvalidDataError, 'mount_network_home must be true or false.' unless newvalue.is_a?(TrueClass) || newvalue.is_a(FalseClass)
+
+        @mount_network_home = newvalue
+
+        container&.should_update
+      end
+
+      # Path at which home folders are placed
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The string path of the folder which user's directory files and folders will be created
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def place_home_folders=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'place_home_folders must be a string.' unless newvalue.is_a? String
+
+            newvalue
             end
 
-            # Set specific groups to become administrators to a system.
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [Array<String>] An array of all the admin group names you want to set.
-            # @see add_admin_group
-            # @see remove_admin_group
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not an Array
-            #
-            # @return [void]
-            def admin_group=(newvalue)
-                
-                raise JSS::InvalidDataError, "An Array must be provided, please use add_admin_group and remove_admin_group for individual group additions and removals." unless newvalue.is_a? Array
-
-                @admin_group = newvalue
-                
-                self.container&.should_update
+        @place_home_folders = new
+
+        container&.should_update
+      end
+
+      # Jamf has these linked for some reason...
+      alias mount_style place_home_folders
+
+      # Map specific UID to Attribute
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The UID you want to be mapped
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def uid=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'uid must be a string, integer, or nil.' unless newvalue.is_a?(String) || newvalue.is_a?(Integer) || newvalue.nil?
+
+            newvalue
             end
 
-
-            # The number of times a user can log into the device while not connected to a network
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [Integer] The number of times you want a user to login while not connected to a network
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not an Integer
-            #
-            # @return [void]
-            def cached_credentials=(newvalue)
-
-                raise JSS::InvalidDataError, "cached_credentials must be an integer." unless newvalue.is_a? Integer
-
-                @cached_credentials = newvalue
-                
-                self.container&.should_update
+        @uid = new
+
+        container&.should_update
+      end
+
+      # Map specific a User's GID to Attribute
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The User's GID you want to be mapped
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def user_gid=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'user_gid must be a string, integer, or nil.' unless newvalue.is_a?(String) || newvalue.is_a?(Integer) || newvalue.nil?
+
+            newvalue
             end
 
-
-            # If the user is a member of one of the groups in admin_group, add them
-            # to the local administrator group.
-            # 
-            # @author Tyler Morgan
-            # @see admin_group
-            #
-            # @param newvalue [Bool]
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a Bool
-            #
-            # @return [void]
-            def add_user_to_local=(newvalue)
-
-                raise JSS::InvalidDataError, "add_user_to_local must be true or false." unless newvalue.is_a? Bool
-
-                @add_user_to_local = newvalue
-                
-                self.container&.should_update
+        @user_gid = new
+
+        container&.should_update
+      end
+
+      # Map specific GID to Attribute
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The GID you want to be mapped
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def gid=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'gid must be a string, integer, or nil.' unless newvalue.is_a?(String) || newvalue.is_a?(Integer) || newvalue.nil?
+
+            newvalue
             end
 
-
-            # An OU path for specific Users
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The OU path for the specific user
-            # @note Not sure what this is used for
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def users_ou=(newvalue)
-
-                raise JSS::InvalidDataError, "users_ou must be either a string or nil." unless newvalue.is_a? String || newvalue.nil?
-
-                @users_ou = newvalue
-                
-                self.container&.should_update
+        @gid = new
+
+        container&.should_update
+      end
+
+      # Set specific groups to become administrators to a system.
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [Array<String>] An array of all the admin group names you want to set.
+      # @see add_admin_group
+      # @see remove_admin_group
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not an Array
+      #
+      # @return [void]
+      def admin_group=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            unless newvalue.is_a? Array
+              raise JSS::InvalidDataError, 'An Array must be provided, please use add_admin_group and remove_admin_group for individual group additions and removals.'
+              end
+
+            newvalue
             end
 
-
-            # An OU path for specific User Groups
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The OU path for the specific user group
-            # @note Not sure what this is used for
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def groups_ou=(newvalue)
-
-                raise JSS::InvalidDataError, "groups_ou must be either a string or nil." unless newvalue.is_a? String || newvalue.nil?
-
-                @groups_ou = newvalue
-                
-                self.container&.should_update
+        @admin_group = new
+
+        container&.should_update
+      end
+
+      # The number of times a user can log into the device while not connected to a network
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [Integer] The number of times you want a user to login while not connected to a network
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not an Integer
+      #
+      # @return [void]
+      def cached_credentials=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'cached_credentials must be an integer.' unless newvalue.is_a? Integer
+
+            newvalue
             end
 
-
-            # An OU path for specific Printers
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The OU path for the specific printer
-            # @note Not sure what this is used for
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def printers_ou=(newvalue)
-
-                raise JSS::InvalidDataError, "printers_ou must be either a string or nil." unless newvalue.is_a? String || newvalue.nil?
-
-                @printers_ou = newvalue
-                
-                self.container&.should_update
+        @cached_credentials = new
+
+        container&.should_update
+      end
+
+      # If the user is a member of one of the groups in admin_group, add them
+      # to the local administrator group.
+      #
+      # @author Tyler Morgan
+      # @see admin_group
+      #
+      # @param newvalue [Bool]
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a Bool
+      #
+      # @return [void]
+      def add_user_to_local=(newvalue)
+        raise JSS::InvalidDataError, 'add_user_to_local must be true or false.' unless newvalue.is_a?(TrueClass) || newvalue.is_a(FalseClass)
+
+        @add_user_to_local = newvalue
+
+        container&.should_update
+      end
+
+      # An OU path for specific Users
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The OU path for the specific user
+      # @note Not sure what this is used for
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def users_ou=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'users_ou must be either a string or nil.' unless newvalue.is_a? String || newvalue.nil?
+
+            newvalue
             end
 
-
-            # An OU path for specific shared folders
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The OU path for the specific shared folders
-            # @note Not sure what this is used for
-            #
-            # @raise [JSS::InvalidDataError] If the new value is not a String
-            #
-            # @return [void]
-            def shared_folders_ou=(newvalue)
-
-                raise JSS::InvalidDataError, "shared_folders_ou must be either a string or nil." unless newvalue.is_a? String || newvalue.nil?
-
-                @shared_folders_ou = newvalue
-                
-                self.container&.should_update
+        @users_ou = new
+
+        container&.should_update
+      end
+
+      # An OU path for specific User Groups
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The OU path for the specific user group
+      # @note Not sure what this is used for
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def groups_ou=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'groups_ou must be either a string or nil.' unless newvalue.is_a? String || newvalue.nil?
+
+            newvalue
             end
 
-            
-            # An a specific admin group to admin_group
-            # 
-            # @author Tyler Morgan
-            #
-            # @param value [String] The admin group name you wish to add to the admin group list
-            #
-            # @raise [JSS::InvalidDataError] If the value provided is not a String
-            # @raise [JSS::InvalidDataError] If the group provided is already a member of the admin_group array
-            #
-            # @return [Array <String>] An array of all the admin groups currently set.
-            def add_admin_group(value)
-
-                raise JSS::InvalidDataError, "Admin group must be a string." unless value.is_a? String
-                raise JSS::InvalidDataError, "Admin group \"#{value}\" already is in the list of admin groups." unless !@admin_group.include? value
-
-                @admin_group << value
-                
-                self.container&.should_update
-
-                return @admin_group
+        @groups_ou = new
+
+        container&.should_update
+      end
+
+      # An OU path for specific Printers
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The OU path for the specific printer
+      # @note Not sure what this is used for
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def printers_ou=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'printers_ou must be either a string or nil.' unless newvalue.is_a? String || newvalue.nil?
+
+            newvalue
             end
 
-
-            # Remove a specific admin group to admin_group
-            # 
-            # @author Tyler Morgan
-            #
-            # @param newvalue [String] The admin group name you wish to remove from the admin group list
-            #
-            # @raise [JSS::InvalidDataError] If the value provided is not a String
-            # @raise [JSS::InvalidDataError] If the group provided is not in the admin_group array
-            #
-            # @return [Array <String>] An array of all the admin groups currently set.
-            def remove_admin_group(value)
-
-                raise JSS::InvalidDataError, "Admin group being removed must be a string" unless value.is_a? String
-                raise JSS::InvalidDataError, "Admin group #{value} is not in the current admin group(s)." unless @admin_group.include? value
-
-                @admin_group.delete value
-
-                self.container&.should_update
-
-                return @admin_group
+        @printers_ou = new
+
+        container&.should_update
+      end
+
+      # An OU path for specific shared folders
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The OU path for the specific shared folders
+      # @note Not sure what this is used for
+      #
+      # @raise [JSS::InvalidDataError] If the new value is not a String
+      #
+      # @return [void]
+      def shared_folders_ou=(newvalue)
+        new =
+          if newvalue.to_s.empty?
+            JSS::BLANK
+          else
+            # Data Check
+            raise JSS::InvalidDataError, 'shared_folders_ou must be either a string or nil.' unless newvalue.is_a? String || newvalue.nil?
+
+            newvalue
             end
 
-
-            # Return a REXML Element containing the current state of the DirectoryBindingType
-            # object for adding into the XML of the container.
-            # 
-            # @author Tyler Morgan
-            #
-            # @return [REXML::Element]
-            def type_setting_xml
-                type_setting = REXML::Element.new "admitmac"
-                type_setting.add_element("require_confirmation").text = @require_confirmation
-                type_setting.add_element("local_home").text = @local_home
-                type_setting.add_element("mount_style").text = @mount_style.downcase
-                type_setting.add_element("default_shell").text = @default_shell
-                type_setting.add_element("mount_network_home").text = @mount_network_home
-                type_setting.add_element("place_home_folders").text = @place_home_folders
-                type_setting.add_element("uid").text = @uid
-                type_setting.add_element("user_gid").text = @user_gid
-                type_setting.add_element("gid").text = @gid
-                type_setting.add_element("add_user_to_local").text = @add_user_to_local
-                type_setting.add_element("cached_credentials").text = @cached_credentials
-                type_setting.add_element("users_ou").text = @users_ou
-                type_setting.add_element("groups_ou").text = @groups_ou
-                type_setting.add_element("printers_ou").text = @printers_ou
-                type_setting.add_element("shared_folders_ou").text = @shared_folders_ou
-                type_setting.add_element("admin_group").text = @admin_group.join(',').to_s unless @admin_group.nil?
-
-                return type_setting
-            end
-        end
+        @shared_folders_ou = new
+
+        container&.should_update
+      end
+
+      # An a specific admin group to admin_group
+      #
+      # @author Tyler Morgan
+      #
+      # @param value [String] The admin group name you wish to add to the admin group list
+      #
+      # @raise [JSS::InvalidDataError] If the value provided is not a String
+      # @raise [JSS::InvalidDataError] If the group provided is already a member of the admin_group array
+      #
+      # @return [Array <String>] An array of all the admin groups currently set.
+      def add_admin_group(value)
+        raise JSS::InvalidDataError, 'Admin group must be a string.' unless value.is_a? String
+        raise JSS::InvalidDataError, "Admin group \"#{value}\" already is in the list of admin groups." if @admin_group.include? value
+
+        @admin_group << value
+
+        container&.should_update
+
+        @admin_group
+      end
+
+      # Remove a specific admin group to admin_group
+      #
+      # @author Tyler Morgan
+      #
+      # @param newvalue [String] The admin group name you wish to remove from the admin group list
+      #
+      # @raise [JSS::InvalidDataError] If the value provided is not a String
+      # @raise [JSS::InvalidDataError] If the group provided is not in the admin_group array
+      #
+      # @return [Array <String>] An array of all the admin groups currently set.
+      def remove_admin_group(value)
+        raise JSS::InvalidDataError, 'Admin group being removed must be a string' unless value.is_a? String
+        raise JSS::InvalidDataError, "Admin group #{value} is not in the current admin group(s)." unless @admin_group.include? value
+
+        @admin_group.delete value
+
+        container&.should_update
+
+        @admin_group
+      end
+
+      # Return a REXML Element containing the current state of the DirectoryBindingType
+      # object for adding into the XML of the container.
+      #
+      # @author Tyler Morgan
+      #
+      # @return [REXML::Element]
+      def type_setting_xml
+        type_setting = REXML::Element.new 'admitmac'
+        type_setting.add_element('require_confirmation').text = @require_confirmation
+        type_setting.add_element('local_home').text = @local_home
+        type_setting.add_element('mount_style').text = @mount_style.downcase
+        type_setting.add_element('default_shell').text = @default_shell
+        type_setting.add_element('mount_network_home').text = @mount_network_home
+        type_setting.add_element('place_home_folders').text = @place_home_folders
+        type_setting.add_element('uid').text = @uid
+        type_setting.add_element('user_gid').text = @user_gid
+        type_setting.add_element('gid').text = @gid
+        type_setting.add_element('add_user_to_local').text = @add_user_to_local
+        type_setting.add_element('cached_credentials').text = @cached_credentials
+        type_setting.add_element('users_ou').text = @users_ou
+        type_setting.add_element('groups_ou').text = @groups_ou
+        type_setting.add_element('printers_ou').text = @printers_ou
+        type_setting.add_element('shared_folders_ou').text = @shared_folders_ou
+        type_setting.add_element('admin_group').text = @admin_group.join(',').to_s unless @admin_group.nil?
+
+        type_setting
+      end
 
     end
 
-end
+  end
+
+end