Skip to main content

Device

Properties​

NameTypeDescriptionNotes
IdStringSystem-generated unique ID of the Object[optional] [readonly]
NameStringName of the Object[required]
CreatedSystem.DateTimeCreation date of the Object[optional] [readonly]
ModifiedSystem.DateTimeLast modification date of the Object[optional] [readonly]
NativeIdentityStringThe device's unique identifier on the source.[optional]
DescriptionStringDescription of the device.[optional]
EnvironmentStringThe environment the device belongs to.[optional]
HostnameStringThe device hostname reported by the source.[optional]
OsDeviceOS[optional]
EmailStringThe email address the source reports for the device.[optional]
SentinelVersionStringThe version of the endpoint agent the source reports for the device.[optional]
DetectionModuleVersionStringThe version of the detection module the source reports for the device.[optional]
SourceDeviceAllOfSource[optional]
ResourceDeviceResource[optional]
DatasetIdStringThe ID of the source dataset the device was retrieved from.[optional]
OwnersDeviceOwners[optional]
ConnectorAttributesmap[string]AnyTypeA map of attributes sourced from the connector during aggregation.[optional]
Attributesmap[string]AnyTypeA map of curated device attributes.[optional]

Examples​

  • Prepare the resource
$Device = Initialize-Device -Id id12345 `
-Name aName `
-Created 2015-05-28T14:07:17Z `
-Modified 2015-05-28T14:07:17Z `
-NativeIdentity 6c2f4a8e-1d3b-4f6a-9e2c-7b5d8a1f0c34 `
-Description Finance team laptop `
-Environment production `
-Hostname lab-mbp-0142 `
-Os null `
-Email jane.doe@example.com `
-SentinelVersion 24.1.2.6 `
-DetectionModuleVersion 3.4.1 `
-Source null `
-Resource null `
-DatasetId 8886e5e3-63d0-462f-a195-d98da885b8dc `
-Owners null `
-ConnectorAttributes {"agentId":1785462398123456800} `
-Attributes {"hostname":"lab-mbp-0142","osType":"macos"}
  • Convert the resource to JSON
$Device | ConvertTo-JSON

[Back to top]