Machine¶
Basic machine information. A machine is a physical or virtual device that can be scanned by OctoSAM Inventory. A machine can also be a mobile device such as a phone or tablet.
Fields¶
| Field | Type | Description |
|---|---|---|
| Active | boolean | If true, do not count this machine for installations |
| AlternateDescription | string | Alternate description field specific to the scanned machine type. For example locally entered description in macOS. |
| AlternateName | string | Contains the computer name for systems that may have different host and computer names, such as macOS |
| AnalysisExtras | xml | Holds additional analysis data |
| BiosAssetTag | string | BIOS asset tag if supported |
| BiosName | string | BIOS Name as reported by WMI |
| BiosSerialNumber | string | BIOS Serial Number as reported by WMI |
| BiosSmBiosUuid | guid | SMBIOS UUID of the machine |
| BiosSmBiosVersion | string | SMBIOS Version as reported by WMI |
| BiosVersion | string | BIOS Version as reported by WMI |
| ChassisTypes | string | ChassisTypes as reported in WMI in cleartext |
| CloudProviderAccountID | numeric | Internal ID that references the CloudProviderAccount entity (Foreign Key) |
| CostCenter | string | Cost center - typically replicated from another system |
| CostCenterID | numeric | Internal ID that references the CostCenter entity (Foreign Key) |
| Created | datetime | Time this object was created |
| CreatedGUID | guid | Scan GUID that created this machine |
| CustomField1 | string | Available for custom data for this machine, not used by OctoSAM Inventory |
| CustomField2 | string | Available for custom data for this machine, not used by OctoSAM Inventory |
| CustomField3 | string | Available for custom data for this Machine, not used by OctoSAM Inventory |
| CustomField4 | string | Available for custom data for this Machine, not used by OctoSAM Inventory |
| DeletedInDirectory | boolean | True, if directory check detects that the machine is no longer found in directory |
| DeletedInDirectoryFirstDetected | datetime | Date/Time the delete flag was set |
| Description | string | Description attribute of the directory service or manually entered during offline scan |
| DirectoryAccountExpires | datetime | accountExpires attribute from ActiveDirectory |
| DirectoryContainerPath | string | Path to the container of this object. Provided for grouping or export to other applications. |
| DirectoryDisabled | boolean | True if the UserAccountControl attribute has the disable bit set |
| DirectoryExt1 | string | Site specific data, can optionally be used to load site-specific extended schema properties |
| DirectoryExt2 | string | Site specific data, can optionally be used to load site-specific extended schema properties |
| DirectoryExt3 | string | Site specific data, can optionally be used to load site-specific extended schema properties |
| DirectoryExt4 | string | Site specific data, can optionally be used to load site-specific extended schema properties |
| DirectoryExtensionAttribute1 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute10 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute11 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute12 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute13 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute14 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute15 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute2 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute3 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute4 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute5 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute6 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute7 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute8 | string | ExtensionAttribute from Active Directory |
| DirectoryExtensionAttribute9 | string | ExtensionAttribute from Active Directory |
| DirectoryGUID | guid | GUID of a machine if joined to active directory and supported by the operating system and scanner |
| DirectoryLastLogonTimestamp | datetime | LastLogonTimestamp attribute from Active Directory (updated on import and on housekeeping). Resolution: 14days. |
| DirectoryLocation | string | Active Directory location attribute |
| DirectoryPath | string | Path where the machine was found in the directory service. Usually an LDAP path. |
| DirectorySiteName | string | Active Directory Site that the machine belongs to |
| DirectoryUserAccountControl | numeric | UserAccountControl attribute from Active Directory (updated on import and on housekeeping) |
| DirectoryWhenChanged | datetime | WhenChanged attribute from Active Directory (updated on import and on housekeeping) |
| DirectoryWhenCreated | datetime | WhenCreated attribute from Active Directory |
| DomainName | string | Windows NETBIOS Domain Name |
| EntraIdApproximateLastSignInDateTime | datetime | ApproximateLastSignInDateTime field Entra ID |
| EntraIdDeviceId | string | Device ID from Entra ID |
| EntraIdDeviceOwnership | string | DeviceOwnership field from Entra ID |
| EntraIdEnrollmentProfileName | string | EnrollmentProfileName field from Entra ID |
| EntraIdExtensionAttribute1 | string | Extension attribute 1 from Entra ID |
| EntraIdExtensionAttribute10 | string | Extension attribute 10 from Entra ID |
| EntraIdExtensionAttribute11 | string | Extension attribute 11 from Entra ID |
| EntraIdExtensionAttribute12 | string | Extension attribute 12 from Entra ID |
| EntraIdExtensionAttribute13 | string | Extension attribute 13 from Entra ID |
| EntraIdExtensionAttribute14 | string | Extension attribute 14 from Entra ID |
| EntraIdExtensionAttribute15 | string | Extension attribute 15 from Entra ID |
| EntraIdExtensionAttribute2 | string | Extension attribute 2 from Entra ID |
| EntraIdExtensionAttribute3 | string | Extension attribute 3 from Entra ID |
| EntraIdExtensionAttribute4 | string | Extension attribute 4 from Entra ID |
| EntraIdExtensionAttribute5 | string | Extension attribute 5 from Entra ID |
| EntraIdExtensionAttribute6 | string | Extension attribute 6 from Entra ID |
| EntraIdExtensionAttribute7 | string | Extension attribute 7 from Entra ID |
| EntraIdExtensionAttribute8 | string | Extension attribute 8 from Entra ID |
| EntraIdExtensionAttribute9 | string | Extension attribute 9 from Entra ID |
| EntraIdId | string | ID from Entra ID |
| EntraIdIsCompliant | boolean | True if this machine is deemed compliant to Entra ID MDM policies |
| EntraIdIsManaged | boolean | True if this machine is managed by Entra ID MDM policies |
| EntraIdOnPremisesLastSyncDateTime | datetime | OnPremisesLastSyncDateTime field from Entra ID |
| EntraIdOnPremisesSyncEnabled | boolean | True if on premises sync is enabled for this machine in Entra ID |
| EntraIdProfileType | string | ProfileType field from Entra ID |
| EntraIdRegistrationDateTime | datetime | RegistrationDateTime field from Entra ID |
| EntraIdTenantId | guid | Entra ID tenant id for machines that are Entra ID joined |
| EntraIdTrustType | string | TrustType field from Entra ID |
| EnvironmentID | numeric | Internal ID that references the Environment entity (Foreign Key) |
| ExcludeFromSoftwareInventory | boolean | If True, the machine is excluded from Software Inventory. Signatures imported for this machine are ignored. This can be useful for development machines used for building of installation packages. |
| ExtraData | string | Extra data collected for documentation of this machine |
| FirstScan | datetime | Date/Time of first scan of this machine |
| FoundInDirectory | boolean | True if the object could be found in Active Directory at last check |
| FullyQualifiedDomainName | string | Fully qualified domain name as seen by the scanner through reverse lookup of the network address |
| Guid | guid | A unique ID that can be used to link to this machine object by external applications |
| HardwareUniqueID | string | Unique hardware ID if supported by the hardware. May not change with operating system re-install for physical systems. |
| HintHasAccessLog | boolean | True if machine has UAL data available |
| HintHasAutoStart | boolean | True if machine has scanned Windows AutosStart information |
| HintHasBrowserExtensions | boolean | |
| HintHasMuiCache | boolean | True if this machine has scanned Windows MUI information |
| HintHasOfficeAddIns | boolean | True if this machine has registered Microsoft Office add-ins |
| HintHasSoftwareItems | boolean | True if software items are linked to this machine |
| HintHasSwidDocuments | boolean | True if machine has scanned SWID documents |
| HintHasWmi | boolean | True if there is hardware and configuration data (WMI) available for the machine |
| HintInGroups | boolean | True if the Machine is member in any group |
| HintIsClusterMember | boolean | True if the machine is member of a custer |
| HintSoftwarePackageUsageEndDate | datetime | Max consolidated usage date for this Machine |
| HintSoftwarePackageUsageStartDate | datetime | Min consolidated usage date for this Machine |
| ID | numeric | Internal ID for the Machine entity (Primary Key) |
| ID | numeric | Internal ID for the Machine entity (Primary Key) |
| IgnoreForRollout | boolean | Reserved for future use |
| IgnoreNewSignatures | boolean | If true, do not create new software signatures if only seen on this machine or others that have the IgnoreNewSignatures flag set. Can be set for test and development machines. |
| ImporterInstance | string | Name of the ImporterInstance. Used if you have multiple import module instances writing into the same database. |
| ImportSourceID | numeric | ID of the import module that created the entity. 1=OctoscanImportService. |
| LastBasicHardwareFromWmi | datetime | Date/Time basic hardware info was last calculated from WMI for this machine |
| LastFoundInDirectory | datetime | Time the object was last found in the directory service |
| LastFoundInEntraId | datetime | Date/Time this device was last found in Entra ID |
| LastHardwareScan | datetime | Time of the last imported WMI scan |
| LastHardwareScanGUID | guid | GUID of the last imported WMI scan |
| LastModification | datetime | Date/Time of last write to this entity |
| LastModifiedBy | string | Windows User ID that last updated this Machine record through the UI |
| LastScan | datetime | Date/Time of the last imported scan for this machine as reported by the machine (may be out of sync) |
| LastScanGUID | guid | GUID of the last imported .scan file for this entity. |
| LastScannerTag | string | Command-line tag that was specified on the last scan of this machine |
| LastSignatureScan | datetime | Time of the last imported software signature scan for this machine |
| LastSignatureScanGUID | guid | GUID of the last imported software signature scan for this machine |
| LastUalScan | datetime | Time of the last imported User Access Logging scan on this machine. Null for machines that don't support UAL. |
| LastUalScanGUID | guid | GUID of the last imported User Access Logging scan on this machine. Null for machines that don't support UAL. |
| LastUserID | numeric | Internal ID that references the User entity (Foreign Key) |
| ManufacturerID | numeric | Internal ID that references the Manufacturer entity (Foreign Key) |
| MappingTag | string | This field can be used for custom mapping logic |
| Model | string | Model of the Machine as defined in WMI |
| MostFrequentUserID | numeric | Internal ID that references the User entity (Foreign Key) |
| MsftDirectAccessConfigured | boolean | True if Microsoft Direct Access configuration was found at last scan |
| Name | string | Machine name (computer name) |
| NetworkAddress | string | Network address, usually the IP number |
| NetworkDefaultGateway | string | Network default gateway |
| NetworkDHCP | boolean | True if DHCP is enabled on the main interface of the machine |
| NetworkDNS | string | Addresses of configured DNS servers |
| NetworkMacAddress | string | MAC address of the main interface (corresponds to NetworkNetworkAddress |
| NetworkNetworkAddress | string | Network address calculated from NetworkAddress and NetworkSubnetkMask fields |
| NetworkNetworkCIDR | string | Network in CIDR notation |
| NetworkNetworkName | string | Network name can be set from an external source. Not used by OctoSAM. |
| NetworkSubnetMask | string | Subnet mask if network address is an ip number |
| Notes | string | Available for custom notes about this entity |
| NumberOfCores | numeric | Number of cores as reported by WMI |
| NumberOfLogicalProcessors | numeric | Number of logical processors as reported by WMI |
| NumberOfProcessors | numeric | Number of processors as reported by WMI |
| ObjectStateID | numeric | Internal ID that references the ObjectState entity (Foreign Key) |
| OperatingSystem | string | Full name of the OS |
| OperatingSystemBits | numeric | 32 or 64 bit |
| OperatingSystemBuild | string | Build number of the OS |
| OperatingSystemCsdVersion | string | CSDVersion field for Windows systems. This file may be interpreted by partner systems such as Flexera One. |
| OperatingSystemDisplayVersion | string | DisplayVersion for operating systems that support this attribute. Newer Windows versions use this instead of ReleaseID. |
| OperatingSystemEdition | string | An OS specific edition marker |
| OperatingSystemExtraData | string | Extra data collected for operating system identification |
| OperatingSystemFamily | string | A short name to identify different operating system families |
| OperatingSystemInstallDate | datetime | Date/Time this OS instance was installed (as reported by WMI) |
| OperatingSystemLanguage | string | Language of the operating system as reported by WMI in cleartext |
| OperatingSystemLastBootUpTime | datetime | DateTime the operating system last booted |
| OperatingSystemMajor | numeric | Major version |
| OperatingSystemMinor | numeric | Minor version |
| OperatingSystemPrintableName | string | Consolidated operating system name for use in queries and reports |
| OperatingSystemProductInfo | numeric | For Windows, contains the result of the GetProductInfo() system call. |
| OperatingSystemProductName | string | For Windows, contains the ProductName value as scanned from the registry. |
| OperatingSystemPublisher | string | Publisher of the OS. |
| OperatingSystemRelease | string | An OS specific release marker. For Windows 10 contains the 'Version'. |
| OperatingSystemServer | boolean | True if this OS is a server version |
| OperatingSystemSoftwarePublisherID | numeric | Internal ID that references the SoftwarePublisher entity (Foreign Key) |
| OperatingSystemSuiteMask | numeric | For Windows, contains the SuiteMask. |
| OperatingSystemUniqueID | string | Unique operating system ID if supported by the operating system. May not change during the lifetime of the operating system instance. May change at re-install of the OS. |
| OperatingSystemUpdateBuildRevision | numeric | Windows UBR number |
| OperatingSystemVersion | string | Additional version information about the OS |
| OracleCoreFactor | float | Oracle Core Factor to use for Oracle pricing. Queries should always use this field. |
| OracleCoreFactorFromCatalog | float | Oracle Core Factor as determined by the OctoSAM catalog |
| OracleCoreFactorManual | float | Optional manually entered Oracle Core Factor |
| OracleCoreFactorOverride | boolean | When True, the manual Oracle Core Factor overrides the factor from the catalog |
| OrganizationID | numeric | Internal ID that references the Organization entity (Foreign Key) |
| PCSystemType | string | PC system type as defined in WMI |
| PhysicalMemory | numeric | Amount of physical memory in the system as reported by WMI |
| PrintableName | string | Use this name in reports for consistency and to avoid having to build the printable name from its parts |
| Processor | string | Processor Name as reported by WMI |
| ProcessorFamily | string | Processor family as defined in WMI |
| ProcessorManufacturerID | numeric | Internal ID that references the Manufacturer entity (Foreign Key) |
| ProcessorSpeed | numeric | Max speed of the processor in MHz |
| RawManufacturer | string | Manufacturer of the machine as defined in WMI |
| Res1 | string | Reserved for future use |
| Res2 | string | Reserved for internal use by future versions |
| Res3 | string | Reserved for future use |
| Res4 | string | Reserved for future use |
| ServiceNowInstallStatus | string | install_status of the computer replicated from ServiceNow |
| ServiceNowLastDiscovered | datetime | |
| ServiceNowLastExport | datetime | Date/Time of last export to ServiceNow |
| ServiceNowLastImport | datetime | Date/time of last import from ServiceNow |
| ServiceNowLifeCycleStage | string | |
| ServiceNowLifeCycleStageStatus | string | |
| ServiceNowOperationalStatus | string | operation_status of the computer replicated from ServiceNow |
| ServiceNowSupportGroup | string | support_group of the computer object in ServiceNow |
| ServiceNowSysID | guid | ServiceNow: sys_id of the replicated object |
| ServiceNowTargetClass | string | ServiceNow: target class of the replicated object |
| SID | string | Computer SID |
| SoftwareDevelopment | boolean | This flag can be set to mark machines used for software development. These machines usually have different licensing requirements. |
| SuggestSoftwareUninstall | boolean | If true, suggest this machine in reports / queries for software uninstalls |
| SynchLastSynch | datetime | Date/Time of last synchronization of this machine with the partner CMDB. Not used by OctoSAM Inventory |
| SynchTokenID | string | Can be used for synchronization with another inventory or CMDB system. Holds the key to the identical item in the CMDB. Not used by OctoSAM Inventory |
| TerminalServicesInstalled | boolean | True, if Terminal Services are installed |
| VirtualizationHost | boolean | True if this machine hosts virtual machines |
| VirtualizationManagementSystemID | numeric | Internal ID that references the VirtualizationManagementSystem entity (Foreign Key) |
| VirtualMachine | boolean | True if this is a virtual machine |
| VirtualMachineGUID | guid | Optional. Used for mapping virtual machine information for MS Hyper-V and possibly other systems that use a GUID to identify a virtual machine. |