Class: JSS::MobileDevice

Inherits:
APIObject show all
Extended by:
Matchable
Includes:
Creatable, Extendable, Locatable, MDM, ManagementHistory, Purchasable, Sitable, Updatable, Uploadable
Defined in:
lib/jss/api_object/mobile_device.rb,
lib/jss.rb

Overview

This class represents a Mobile Device stored in the JSS.


Adding devices to the JSS

When creating new MobileDevices in the JSS with this class (using make) you must specify a udid, and serial_number before calling `create` or `save`. You can provide these values with the `.make` call, or afterward using setters.


Management History & Logs

MobileDevice Management History and logs can now be retrieved both from a MobileDevice instance, and directly via class methods without fetching an instance. This is handled by the mixed-in ManagementHistory module, Q.V. for details.


MDM Commands

See the MDM mixin module for Class and Instance methods for sending MDM commands to mobiledevices.

To send MDM commands without fetching mobiledevice instances, use the class methods, which can take multiple identifiers at once.

NOTE: If the #name= method is used to change the name of a supervized device, the DeviceName MDM command will be sent to the device when the changes are sent to the server via APIObject#save or #update

Constant Summary collapse

RSRC_BASE =

The base for REST resources of this class

'mobiledevices'.freeze
RSRC_LIST_KEY =

the hash key used for the JSON list output of all objects in the JSS

:mobile_devices
RSRC_OBJECT_KEY =

The hash key used for the JSON object output. It's also used in various error messages

:mobile_device
SITE_SUBSET =

Where is the Site data in the API JSON?

:general
VALID_DATA_KEYS =

these keys, as well as :id and :name, are present in valid API JSON data for this class

%i[device_name capacity tethered].freeze
OTHER_LOOKUP_KEYS =

these keys, as well as :id and :name, can be used to look up objects of this class in the JSS

{
  udid: { rsrc_key: :udid, list: :all_udids },
  serialnumber: { rsrc_key: :serialnumber, list: :all_serial_numbers },
  serial_number: { rsrc_key: :serialnumber, list: :all_serial_numbers },
  macaddress: { rsrc_key: :macaddress, list: :all_wifi_mac_addresses },
  mac_address: { rsrc_key: :macaddress, list: :all_wifi_mac_addresses }
}.freeze
SEARCH_CLASS =

This class lets us seach for computers

JSS::AdvancedMobileDeviceSearch
EXT_ATTRIB_CLASS =

This is the class for relevant Extension Attributes

JSS::MobileDeviceExtensionAttribute
MDM_COMMAND_TARGET =

What kind of devices are we for MDM purposes?

:mobiledevices
OBJECT_HISTORY_OBJECT_TYPE =

the object type for this object in the object history table. See APIObject#add_object_history_entry

21

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(args = {}) ⇒ MobileDevice

When creating new records with .make, udid:, serial_number:, and asset_tag: can be provided in the args.


422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
# File 'lib/jss/api_object/mobile_device.rb', line 422

def initialize(args = {})
  super args
  if @in_jss

    gen = @init_data[:general]

    # identifiers
    @serial_number = gen[:serial_number]
    @udid = gen[:udid]
    @asset_tag = gen[:asset_tag]
    @device_id = gen[:device_id]
    @device_name = gen[:device_name]
    @display_name = gen[:display_name]
    @exchange_activesync_device_identifier = gen[:exchange_activesync_device_identifier]

    # settings
    @managed = gen[:managed]
    @supervised = gen[:supervised]
    @device_ownership_level = gen[:device_ownership_level]
    @tethered = gen[:tethered]
    @shared = gen[:shared]
    @ble_capable = gen[:ble_capable]

    @airplay_password = gen[:airplay_password]
    @languages = gen[:languages]
    @locales = gen[:locales]

    # software
    @os_type = gen[:os_type]
    @os_build = gen[:os_build]
    @os_version = gen[:os_version]
    @modem_firmware = gen[:modem_firmware]

    # hardware
    @model = gen[:model]
    @model_number = gen[:model_number]
    @model_identifier = gen[:model_identifier]
    @model_display = gen[:model_display]

    # usage
    @capacity_mb = gen[:capacity_mb]
    @available_mb = gen[:available_mb]
    @percentage_used = gen[:percentage_used]
    @battery_level = gen[:battery_level]

    # network
    @bluetooth_mac_address = gen[:bluetooth_mac_address]
    @wifi_mac_address = gen[:wifi_mac_address]
    @sim_phone_number = gen[:phone_number]
    @ip_address = gen[:ip_address]

    # timestamps
    @initial_entry_date = JSS.epoch_to_time gen[:initial_entry_date_epoch]
    @last_backup_time = JSS.epoch_to_time gen[:last_backup_time_epoch]
    @last_cloud_backup_date = JSS.epoch_to_time gen[:last_cloud_backup_date_epoch]
    @last_inventory_update = JSS.epoch_to_time gen[:last_inventory_update_epoch]
    @last_enrollment = JSS.epoch_to_time gen[:last_enrollment_epoch]

    # subsets
    @mobile_device_groups = @init_data[:mobile_device_groups]
    @network = @init_data[:network]
    @extension_attributes = @init_data[:extension_attributes]
    @certificates = @init_data[:certificates]
    @configuration_profiles = @init_data[:configuration_profiles]
    @provisioning_profiles = @init_data[:provisioning_profiles]
    @security = @init_data[:security]
    @applications = @init_data[:applications]
  else
    @udid = args[:udid]
    @serial_number = args[:serial_number]
    @asset_tag = args[:asset_tag]
  end
end

Instance Attribute Details

#airplay_passwordString (readonly)


248
249
250
# File 'lib/jss/api_object/mobile_device.rb', line 248

def airplay_password
  @airplay_password
end

#applecare_idString Originally defined in module Purchasable

#applicationsArray<Hash> (readonly)


343
344
345
# File 'lib/jss/api_object/mobile_device.rb', line 343

def applications
  @applications
end

#asset_tagString


210
211
212
# File 'lib/jss/api_object/mobile_device.rb', line 210

def asset_tag
  @asset_tag
end

#available_mbIntger (readonly) Also known as: available


290
291
292
# File 'lib/jss/api_object/mobile_device.rb', line 290

def available_mb
  @available_mb
end

#battery_levelInteger (readonly) Also known as: battery_percent


301
302
303
# File 'lib/jss/api_object/mobile_device.rb', line 301

def battery_level
  @battery_level
end

#ble_capableBoolean (readonly)


245
246
247
# File 'lib/jss/api_object/mobile_device.rb', line 245

def ble_capable
  @ble_capable
end

#bluetooth_mac_addressString (readonly)


308
309
310
# File 'lib/jss/api_object/mobile_device.rb', line 308

def bluetooth_mac_address
  @bluetooth_mac_address
end

#buildingString Originally defined in module Locatable

#capacity_mbInteger (readonly) Also known as: capacity


294
295
296
# File 'lib/jss/api_object/mobile_device.rb', line 294

def capacity_mb
  @capacity_mb
end

#certificatesArray<Hash> (readonly)

The certificates on the device

Each has has two keys:

  • :identity => Boolean

  • :common_name => String, possibly a udid


352
353
354
# File 'lib/jss/api_object/mobile_device.rb', line 352

def certificates
  @certificates
end

#configuration_profilesArray<Hash> (readonly)

One for each ConfigurationProfile on the device

The Hash keys are:

  • :identifier => a unique id, often the sams as the uuid

  • :display_name => its name in the JSS

  • :uuid => the ConfigurationProfile uuid

  • :version => a String


363
364
365
# File 'lib/jss/api_object/mobile_device.rb', line 363

def configuration_profiles
  @configuration_profiles
end

#departmentString Originally defined in module Locatable

#device_idString (readonly)


219
220
221
# File 'lib/jss/api_object/mobile_device.rb', line 219

def device_id
  @device_id
end

#device_nameString (readonly)


216
217
218
# File 'lib/jss/api_object/mobile_device.rb', line 216

def device_name
  @device_name
end

#device_ownership_levelString (readonly)


236
237
238
# File 'lib/jss/api_object/mobile_device.rb', line 236

def device_ownership_level
  @device_ownership_level
end

#display_nameString (readonly)


213
214
215
# File 'lib/jss/api_object/mobile_device.rb', line 213

def display_name
  @display_name
end

#email_addressString Originally defined in module Locatable

#exchange_activesync_device_identifierString (readonly)


222
223
224
# File 'lib/jss/api_object/mobile_device.rb', line 222

def exchange_activesync_device_identifier
  @exchange_activesync_device_identifier
end

#ext_attrsHash (readonly) Originally defined in module Extendable

#extension_attributesArray<Hash> (readonly) Originally defined in module Extendable

#initial_entry_dateTime (readonly)


324
325
326
# File 'lib/jss/api_object/mobile_device.rb', line 324

def 
  @initial_entry_date
end

#ip_addressString (readonly)


314
315
316
# File 'lib/jss/api_object/mobile_device.rb', line 314

def ip_address
  @ip_address
end

#is_leasedBoolean Also known as: leased? Originally defined in module Purchasable

#is_purchasedBoolean Also known as: purchased? Originally defined in module Purchasable

#languagesString (readonly)


251
252
253
# File 'lib/jss/api_object/mobile_device.rb', line 251

def languages
  @languages
end

#last_backup_timeTime (readonly) Also known as: last_backup_date, last_backup


327
328
329
# File 'lib/jss/api_object/mobile_device.rb', line 327

def last_backup_time
  @last_backup_time
end

#last_cloud_backup_dateTime (readonly)


338
339
340
# File 'lib/jss/api_object/mobile_device.rb', line 338

def last_cloud_backup_date
  @last_cloud_backup_date
end

#last_enrollmentTime (readonly)


335
336
337
# File 'lib/jss/api_object/mobile_device.rb', line 335

def last_enrollment
  @last_enrollment
end

#last_inventory_updateTime (readonly)


332
333
334
# File 'lib/jss/api_object/mobile_device.rb', line 332

def last_inventory_update
  @last_inventory_update
end

#lease_expiresTime Originally defined in module Purchasable

#life_expectancyInteger Originally defined in module Purchasable

#localesString (readonly)


254
255
256
# File 'lib/jss/api_object/mobile_device.rb', line 254

def locales
  @locales
end

#managedBoolean (readonly) Also known as: managed?


228
229
230
# File 'lib/jss/api_object/mobile_device.rb', line 228

def managed
  @managed
end

#mobile_device_groupsArray<Hash> (readonly)

One for each group to which the device belongs

The Hash keys are:

  • :name => the group name

  • :id => the group id in the JSS


372
373
374
# File 'lib/jss/api_object/mobile_device.rb', line 372

def mobile_device_groups
  @mobile_device_groups
end

#modelString (readonly)


275
276
277
# File 'lib/jss/api_object/mobile_device.rb', line 275

def model
  @model
end

#model_displayString (readonly)


281
282
283
# File 'lib/jss/api_object/mobile_device.rb', line 281

def model_display
  @model_display
end

#model_identifierString (readonly)


284
285
286
# File 'lib/jss/api_object/mobile_device.rb', line 284

def model_identifier
  @model_identifier
end

#model_numberString (readonly)


278
279
280
# File 'lib/jss/api_object/mobile_device.rb', line 278

def model_number
  @model_number
end

#modem_firmwareString (readonly)


260
261
262
# File 'lib/jss/api_object/mobile_device.rb', line 260

def modem_firmware
  @modem_firmware
end

#need_to_updateBoolean (readonly) Originally defined in module Updatable

#networkHash (readonly)

A Hash of network data

The Hash keys are:

  • :voice_roaming_enabled=>“Disabled”,

  • :current_mobile_network_code=>“nnn”,

  • :imei=>“nn nnnnnn nnnnnn n”,

  • :home_mobile_country_code=>“nnn”,

  • :iccid=>“nnnn nnnn nnnn nnnn nnnn”,

  • :home_mobile_network_code=>“nnn”,

  • :current_carrier_network=>“”,

  • :data_roaming_enabled=>false,

  • :home_carrier_network=>“AT&T”,

  • :carrier_settings_version=>“16.0”,

  • :roaming=>false,

  • :cellular_technology=>“GSM”,

  • :current_mobile_country_code=>“nnn”


392
393
394
# File 'lib/jss/api_object/mobile_device.rb', line 392

def network
  @network
end

#os_buildString (readonly)


266
267
268
# File 'lib/jss/api_object/mobile_device.rb', line 266

def os_build
  @os_build
end

#os_typeString (readonly)


269
270
271
# File 'lib/jss/api_object/mobile_device.rb', line 269

def os_type
  @os_type
end

#os_versionString (readonly)


263
264
265
# File 'lib/jss/api_object/mobile_device.rb', line 263

def os_version
  @os_version
end

#percentage_usedInteger (readonly)


298
299
300
# File 'lib/jss/api_object/mobile_device.rb', line 298

def percentage_used
  @percentage_used
end

#phoneString Originally defined in module Locatable

#po_dateTime Originally defined in module Purchasable

#po_numberString Originally defined in module Purchasable

#positionString Originally defined in module Locatable

#provisioning_profilesArray<Hash> (readonly)

One per provisioning profile


398
399
400
# File 'lib/jss/api_object/mobile_device.rb', line 398

def provisioning_profiles
  @provisioning_profiles
end

#purchase_priceFloat Originally defined in module Purchasable

#purchasing_accountString Originally defined in module Purchasable

#purchasing_contactString Originally defined in module Purchasable

#real_nameString Originally defined in module Locatable

#roomString Originally defined in module Locatable

#securityHash (readonly)

A Hash of security data

The Hash has these keys, all of which are Boolean

  • :passcode_present=>true,

  • :passcode_compliant=>true,

  • :passcode_compliant_with_profile=>true,

  • :data_protection=>true,

  • :block_level_encryption_capable=>true,

  • :file_level_encryption_capable=>true


411
412
413
# File 'lib/jss/api_object/mobile_device.rb', line 411

def security
  @security
end

#serial_numberString Also known as: sn, serialnumber


202
203
204
# File 'lib/jss/api_object/mobile_device.rb', line 202

def serial_number
  @serial_number
end

#sharedBoolean (readonly)


242
243
244
# File 'lib/jss/api_object/mobile_device.rb', line 242

def shared
  @shared
end

#sim_phone_numberString (readonly) Also known as: device_phone_number


317
318
319
# File 'lib/jss/api_object/mobile_device.rb', line 317

def sim_phone_number
  @sim_phone_number
end

#supervisedBoolean (readonly) Also known as: supervised?


232
233
234
# File 'lib/jss/api_object/mobile_device.rb', line 232

def supervised
  @supervised
end

#tetheredString (readonly)


239
240
241
# File 'lib/jss/api_object/mobile_device.rb', line 239

def tethered
  @tethered
end

#udidString


207
208
209
# File 'lib/jss/api_object/mobile_device.rb', line 207

def udid
  @udid
end

#usernameString Also known as: user Originally defined in module Locatable

#vendorString Originally defined in module Purchasable

#warranty_expiresTime Originally defined in module Purchasable

#wifi_mac_addressString (readonly)


311
312
313
# File 'lib/jss/api_object/mobile_device.rb', line 311

def wifi_mac_address
  @wifi_mac_address
end

Class Method Details

.all_apple_tvs(refresh = false, api: JSS.api) ⇒ Array<Hash>


188
189
190
# File 'lib/jss/api_object/mobile_device.rb', line 188

def self.all_apple_tvs(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |d| d[:model_identifier].start_with? 'AppleTV' }
end

.all_ipads(refresh = false, api: JSS.api) ⇒ Array<Hash>


183
184
185
# File 'lib/jss/api_object/mobile_device.rb', line 183

def self.all_ipads(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |d| d[:model].start_with? 'iPad' }
end

.all_iphones(refresh = false, api: JSS.api) ⇒ Array<Hash>


178
179
180
# File 'lib/jss/api_object/mobile_device.rb', line 178

def self.all_iphones(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |d| d[:model].start_with? 'iPhone' }
end

.all_mac_addresses(refresh = false, api: JSS.api) ⇒ Array<String>


148
149
150
# File 'lib/jss/api_object/mobile_device.rb', line 148

def self.all_mac_addresses(refresh = false, api: JSS.api)
  all_wifi_mac_addresses(refresh, api: api)
end

.all_managed(refresh = false, api: JSS.api) ⇒ Array<Hash>


158
159
160
# File 'lib/jss/api_object/mobile_device.rb', line 158

def self.all_managed(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |d| d[:managed] }
end

.all_phone_numbers(refresh = false, api: JSS.api) ⇒ Array<String>


138
139
140
# File 'lib/jss/api_object/mobile_device.rb', line 138

def self.all_phone_numbers(refresh = false, api: JSS.api)
  all(refresh, api: api).map { |i| i[:phone_number] }.reject(&:empty?)
end

.all_serial_numbers(refresh = false, api: JSS.api) ⇒ Array<String>


133
134
135
# File 'lib/jss/api_object/mobile_device.rb', line 133

def self.all_serial_numbers(refresh = false, api: JSS.api)
  all(refresh, api: api).map { |i| i[:serial_number] }
end

.all_supervised(refresh = false, api: JSS.api) ⇒ Array<Hash>


168
169
170
# File 'lib/jss/api_object/mobile_device.rb', line 168

def self.all_supervised(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |d| d[:supervised] }
end

.all_udids(refresh = false, api: JSS.api) ⇒ Array<String>


153
154
155
# File 'lib/jss/api_object/mobile_device.rb', line 153

def self.all_udids(refresh = false, api: JSS.api)
  all(refresh, api: api).map { |i| i[:udid] }
end

.all_unmanaged(refresh = false, api: JSS.api) ⇒ Array<Hash>


163
164
165
# File 'lib/jss/api_object/mobile_device.rb', line 163

def self.all_unmanaged(refresh = false, api: JSS.api)
  all(refresh, api: api).reject { |d| d[:managed] }
end

.all_unsupervised(refresh = false, api: JSS.api) ⇒ Array<Hash>


173
174
175
# File 'lib/jss/api_object/mobile_device.rb', line 173

def self.all_unsupervised(refresh = false, api: JSS.api)
  all(refresh, api: api).reject { |d| d[:supervised] }
end

.all_wifi_mac_addresses(refresh = false, api: JSS.api) ⇒ Array<String>


143
144
145
# File 'lib/jss/api_object/mobile_device.rb', line 143

def self.all_wifi_mac_addresses(refresh = false, api: JSS.api)
  all(refresh, api: api).map { |i| i[:wifi_mac_address] }
end

.match(term, api: JSS.api) ⇒ Array<Hash> Originally defined in module Matchable

Perform a match, returning an Array of Hashes, one for each item matched

At the moment, it appears the search is an “exact match” search regardless of the prefs of the user connected to the API.

Instance Method Details

#app_store_app_history(status = nil) ⇒ Object Also known as: managed_app_history Originally defined in module ManagementHistory

Wrapper for app store history for both computers and mobile devices

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#audit_historyObject Also known as: audits Originally defined in module ManagementHistory

The audit_history for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#blank_pushvoid Also known as: send_blank_push, noop Originally defined in module MDM

This method returns an undefined value.

Send a blank push to this object

#casper_imaging_logsObject Originally defined in module ManagementHistory

The casper_imaging_logs for this computer

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#casper_remote_logsObject Originally defined in module ManagementHistory

The casper_remote_logs for this computer

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#clear_locationvoid Originally defined in module Locatable

This method returns an undefined value.

Clear all location data

#clear_passcodeObject Originally defined in module MDM

Send an clear_passcode command to this object

#clear_restrictions_passwordObject Originally defined in module MDM

Send an clear_restrictions_password command to this object

#clone(new_name, api: nil) ⇒ APIObject Originally defined in module Creatable

make a clone of this API object, with a new name. The class must be creatable

#completed_mdm_commandsObject Also known as: completed_commands Originally defined in module ManagementHistory

The completed_mdm_commands for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#completed_policiesObject Originally defined in module ManagementHistory

The array from .policy_logs, limited to status = :completed

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#computer_usage_logsObject Also known as: usage_logs Originally defined in module ManagementHistory

The computer_usage_logs for this computer

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#create(api: nil) ⇒ Integer Originally defined in module Creatable

Create a new object in the JSS.

#delete_user(user) ⇒ Object Originally defined in module MDM

Send a delete_user command to this computer or group

#device_lock(passcode_or_message = '') ⇒ Object Also known as: lock, lock_device Originally defined in module MDM

Send a dev lock to this object

#disable_app_analyticsObject Originally defined in module MDM

Send a disable_app_analytics command to this object

#disable_data_roamingObject Originally defined in module MDM

Send a disable_data_roaming command to this object

#disable_diagnostic_submissionObject Originally defined in module MDM

Send a disable_diagnostic_submission command to this object

#disable_lost_modeObject Originally defined in module MDM

Send a disable_lost_mode command to this object

#disable_voice_roamingObject Originally defined in module MDM

Send a disable_voice_roaming command to this object

#ebook_history(status = nil) ⇒ Object Also known as: managed_ebook_history Originally defined in module ManagementHistory

The ebook_history for this mobile device

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#enable_app_analyticsObject Originally defined in module MDM

Send an enable_app_analytics command to this object

#enable_data_roamingObject Originally defined in module MDM

Send an enable_data_roaming command to this object

#enable_diagnostic_submissionObject Originally defined in module MDM

Send an enable_diagnostic_submission command to this object

#enable_lost_mode(message: nil, phone_number: nil, footnote: nil, enforce_lost_mode: true, play_sound: false) ⇒ Object Originally defined in module MDM

Send a enable_lost_mode command to one or more targets

Either or both of message and phone number must be provided

#enable_voice_roamingObject Originally defined in module MDM

Send an enable_voice_roaming command to this object

#erase_device(passcode = '', preserve_data_plan: false) ⇒ Object Also known as: wipe_device, wipe_computer, wipe, erase Originally defined in module MDM

Send an erase device command to this object

#ext_attr_xmlREXML::Element Originally defined in module Extendable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

TODO: make this (and all XML amending) method take the in-progress XML doc and add (or not) the EA xml to it. See how Sitable#add_site_to_xml works, as called from Computer.rest_xml

#failed_app_store_appsObject Also known as: failed_managed_apps Originally defined in module ManagementHistory

shortcut for app_store_app_history where status = :failed

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#failed_ebooksObject Also known as: failed_managed_ebooks Originally defined in module ManagementHistory

shortcut for ebook_history where status = :failed

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#failed_mdm_commandsObject Also known as: failed_commands Originally defined in module ManagementHistory

The failed_mdm_commands for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#failed_policiesObject Originally defined in module ManagementHistory

The array from .policy_logs, limited to status = :failed

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#flush_mdm_commands(status) ⇒ void Originally defined in module MDM

This method returns an undefined value.

flush pending and/or failed MDM commands for this object

#has_location?Boolean Originally defined in module Locatable

#has_purchasing?Boolean Originally defined in module Purchasable

#installed_app_store_appsObject Also known as: installed_managed_apps Originally defined in module ManagementHistory

shortcut for app_store_app_history where status = :installed

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#installed_ebooksObject Also known as: installed_managed_ebooks Originally defined in module ManagementHistory

shortcut for ebook_history where status = :installed

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#locationHash<String> Originally defined in module Locatable

All the location data in a Hash, as it comes from the API.

The reason it isn't stored this way is to prevent editing of the hash directly.

#location_xmlREXML::Element Originally defined in module Locatable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return a REXML <location> element to be included in the rest_xml of objects that have a Location subset

#mac_app_store_app_history(status = nil) ⇒ Object Originally defined in module ManagementHistory

The mac_app_store_app_history for this computer

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#management_history(subset = nil) ⇒ Object Also known as: history Originally defined in module ManagementHistory

The raw management history data for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#mdm_command_history(status = nil) ⇒ Object Also known as: commands, management_command_history Originally defined in module ManagementHistory

The mdm_command_history for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#mobile_device_app_history(status = nil) ⇒ Object Originally defined in module ManagementHistory

The mobile_device_app_history for this mobile device

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#name=(new_name) ⇒ Object

initialize


496
497
498
499
# File 'lib/jss/api_object/mobile_device.rb', line 496

def name=(new_name)
  super
  @needs_mdm_name_change = true if managed? && supervised?
end

#parse_ext_attrsvoid Originally defined in module Extendable

This method returns an undefined value.

Populate @extension_attributes (the Array of Hashes that comes from the API) and @ext_attr_names, which is a Hash mapping the EA names to their values. This is called during initialization for all objects that mix in this module

#parse_locationvoid Originally defined in module Locatable

This method returns an undefined value.

Call this during initialization of objects that have a Location subset and the location attributes will be populated (as primary attributes) from @init_data

#parse_purchasingObject Originally defined in module Purchasable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Call this during initialization of objects that have a Purchasing subset and the purchasing attribute will be populated from @init_data

#passcode_lock_grace_period(secs) ⇒ Object Originally defined in module MDM

Send a passcode_lock_grace_period command to this object

#pending_app_store_appsObject Also known as: pending_managed_apps Originally defined in module ManagementHistory

shortcut for app_store_app_history where status = :pending

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#pending_ebooksObject Also known as: pending_managed_ebooks Originally defined in module ManagementHistory

shortcut for ebook_history where status = :pending

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#pending_mdm_commandsObject Also known as: pending_commands Originally defined in module ManagementHistory

The pending_mdm_commands for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#play_lost_mode_soundObject Originally defined in module MDM

Send a play_lost_mode_sound command to this object

#policy_logsObject Originally defined in module ManagementHistory

The policy_logs for this computer

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#purchasingHash<String> Originally defined in module Purchasable

All the purchasing data in a Hash, as it comes from the API.

The reason it isn't stored this way is to prevent editing of the hash directly.

#purchasing_xmlREXML::Element Originally defined in module Purchasable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns A <purchasing> element to be included in the rest_xml of objects that mix-in this module.

#restart_deviceObject Also known as: restart Originally defined in module MDM

Send a restart_device command to this object

#screen_sharing_logsObject Originally defined in module ManagementHistory

The screen_sharing_logs for this computer

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#set_ext_attr(name, value) ⇒ void Originally defined in module Extendable

This method returns an undefined value.

Set the value of an extension attribute

If the extension attribute is defined as a popup menu, the value must be one of the defined popup choices, or an empty string

If the ext. attrib. is defined with a data type of Integer, the value must be an Integer.

If the ext. attrib. is defined with a data type of Date, the value will be converted to a Time

Note that while the Jamf Pro Web interface does not allow editing the values of Extension Attributes populated by Scripts or LDAP, the API does allow it. Bear in mind however that those values will be reset again at the next recon.

#shut_down_deviceObject Also known as: shutdown_device, shut_down, shutdown Originally defined in module MDM

Send a shut_down_device command to this object

#site=(new_site) ⇒ void Originally defined in module Sitable

This method returns an undefined value.

Change the site of this object. Any of the NON_SITES values will unset the site

#site_assigned?Boolean Originally defined in module Sitable

Does this object have a site assigned?

#site_idInteger Originally defined in module Sitable

The id of the site for this object.

#site_nameString Also known as: site Originally defined in module Sitable

The name of the site for this object. For backward compatibility, this is aliased to just 'site'

#site_objectJSS::Site Originally defined in module Sitable

The JSS::Site instance for this object's site

#unlock_user_account(user) ⇒ Object Originally defined in module MDM

Send an unlock_user_account command to this computer or group

#unmanage_deviceObject Also known as: remove_mdm_profile Originally defined in module MDM

Send an unmanage device command to this object

NOTE: when used with computers, the mdm profile will probably be re-installed immediately unless the computer is also no longer managed by Jamf Pro itself. To fully unmanage a computer, use the Computer#make_unmanaged instance method.

#unsaved_eas?Boolean Originally defined in module Extendable

are there any changes in the EAs needing to be saved?

#unset_sitevoid Originally defined in module Sitable

This method returns an undefined value.

Set the site to nothing

#updateObject


524
525
526
527
528
529
# File 'lib/jss/api_object/mobile_device.rb', line 524

def update
  super
  return unless @needs_mdm_name_change
  set_device_name @name if managed? && supervised?
  @needs_mdm_name_change = false
end

#update_inventoryObject Also known as: recon Originally defined in module MDM

Send an update_inventory command to this object

#upload(type, local_file) ⇒ String Originally defined in module Uploadable

Upload a file to the JSS via the REST Resource of the object to which this module is mixed in.

#user_location_historyObject Originally defined in module ManagementHistory

The user_location_history for this object

See Also:

  • matching method in {JSS::ManagementHistory::ClassMethods}

#wallpaper(wallpaper_setting: nil, wallpaper_content: nil, wallpaper_id: nil) ⇒ Object Also known as: set_wallpaper Originally defined in module MDM

Send a wallpaper command to this object