1E Explorer TachyonAgent product pack

Classic Product Pack used to create the 1E Explorer TachyonAgent instruction set that can be used to configure and query 1E clients.

Please refer to:

  • Endpoint Troubleshooting - Using Device Criticality about instructions used to get and set Criticality devices.

  • Endpoint Troubleshooting - Using Location about instructions used to get and set Location on devices.

  • Endpoint Troubleshooting - Client Activity Record about instructions used to configure 1E Client configuration settings for 1E Agent inventory.

Instructions

Instruction text (ReadablePayload)

Type

Description

Instruction file name

Version

What is the Tachyon Agent's connection summary?

Question

Retrieves connectivity diagnostic information from 1E Agents.

1E-Explorer-TachyonAgent-AgentConnectionDiagnostics

11

What is the Tachyon Agent diagnostic information detail?

Question

Get live diagnostic information from 1E Agents.

1E-Explorer-TachyonAgent-AgentDiagnostics

11

What is the Tachyon Agent instruction execution summary?

Question

Retrieves instruction execution diagnostic information from Tachyon Agents.

1E-Explorer-TachyonAgent-AgentExecutionDiagnostics

11

Which devices are connected to which Tachyon Switches?

Question

Get Switch connection information for each device.

1E-Explorer-TachyonAgent-AgentSwitchConnections

11

How many 1E Clients are installed?

Question

Returns a count of each version of 1E Client installed.

1E-Explorer-TachyonAgent-AgentVersionCount

11

Disable 1E Client process usage inventory collection

Action

Disables process usage inventory collection. This only affects Windows devices, and will take up to the 1E Client configuration setting 'ConnectionRetryTimeInSecondsMax' to take effect.

Please refer to Client Activity Record.

1E-Explorer-TachyonAgent-DisableProcessUsage

4

Echo message <msg>

Question

Send an echo request to devices

1E-Explorer-TachyonAgent-Echo

11

Enable 1E Client process usage inventory collection

Action

Enables process usage inventory collection. This only affects Windows devices, and will take up to the 1E Client configuration setting 'ConnectionRetryTimeInSecondsMax' to take effect.

Please refer to Client Activity Record.

1E-Explorer-TachyonAgent-EnableProcessUsage

4

What are the modules and providers reported by the 1E Client Extensibility Update?

Question

Get a list of modules and providers registered with each 1E Client.

1E-Explorer-TachyonAgent-Extensibility

11

What are the 1E Client settings?

Question

Returns values of settings configured on the 1E Client. This instruction makes use of a PowerShell script and will only work on Windows devices.

Uses getConfig.ps1 script to get the following subset of configuration settings for the Tachyon client:

  • AuthenticationPolicy

  • BackgroundChannelUrl

  • ConnectionKeepaliveTimeInSecondsMax

  • ConnectionKeepaliveTimeInSecondsMin

  • ConnectionRetryTimeInSecondsMax

  • ConnectionRetryTimeInSecondsMin

  • ConnectionTimeout

  • CRLChecks

  • CRLTimeoutInSeconds

  • DefaultStaggerRangeSeconds

  • EnablePayloadCompression

  • LoggingLevel

  • NomadContentDownloadEnabled

  • NomadContentDownloadTimeoutSecs

  • Switch

  • WorkerThreads

Please refer to 1E Client settings.

1E-Explorer-TachyonAgent-GetAgentConfigValues

14

What 1E Client Windows settings are configured for historical data collection for the <source> capture source?

Question

Return the 1E Client configuration settings for 1E Agent inventory. The 1E Client configuration settings are read to determine if a supplied inventory source is enabled or disabled. Allowable inventory sources are DNS, Process, Software and TCP. Response speed will be affected by the 1E Client setting 'DefaultStaggerRangeSeconds'. Windows devices only.

Uses getInventoryConfig.ps1 script.

Please refer to Client Activity Record.

1E-Explorer-TachyonAgent-GetAgentHistoricDataCaptureConfig

15

What is the criticality of my devices?

Question

Retrieves the criticality of a device.

1E-Explorer-TachyonAgent-GetCriticality

4

Get the location of my devices

Question

Gets the location of a device. This instruction retrieves the device static location information.

1E-Explorer-TachyonAgent-GetLocation

4

What are the statistics for previously executed instructions?

Question

Returns statistics for previously executed instructions.

1E-Explorer-TachyonAgent-InstructionStatistics

11

Trigger client reinstallation for targeted devices using <ClientVersion> supplying switch name of <switch> and a background channel url of <backgroundchannelurl>

Action

Triggers 1E Client uninstallation followed by an installation via scheduled task for targeted devices. Will use the existing switch and port information (3.0 and above). Only supported on Windows. Uses installers uploaded to the 1E Client installer page within Configuration under the Settings app.

Uses TachyonAgentReinstallation.ps1 script.

1E-Explorer-TachyonAgent-ReinstallationOfAgent

27

Set a 1E Client configuration property <agentconfig> to <agentconfigvalue> for the Tachyon Agent

Action

Set a 1E Client configuration property for the Tachyon Agent. Please note this can and will replace anything found, and can cause the Agent to stop responding. This instruction is for Windows devices only.

Uses setConfig.ps1 script to set the same subset of configuration settings for the Tachyon client as the 1E-Explorer-TachyonAgent-GetAgentConfigValues instruction above.

1E-Explorer-TachyonAgent-SetAgentConfigValue

14

Set the criticality of my devices to <criticality>

Action

Sets the criticality of a device.

1E-Explorer-TachyonAgent-SetCriticality

4

Set the location of my devices to <location>

Action

Sets the location of a device. This instructions set the device static location information.

1E-Explorer-TachyonAgent-SetLocation

4

Check for 1E Client updates and apply them

Action

Instructs the 1E Client to check for extensibility updates and apply them.

Supports Windows, Linux, Solaris and Android.

1E-Explorer-TachyonAgent-UpdateExtensibility

11

Trigger 1E Client upgrade to <ClientVersion> for targeted devices

Action

Triggers 1E Client upgrade via scheduled task for targeted devices. Will use the existing switch and port information (3.1 and above). Only supported on windows 7 and above. Uses installers that are uploaded to the 1E Client installer page within Configuration under the Settings app. Note the build numbers must match between the instruction parameters and the version specified in the 1E Client installer page.

Uses TachyonAgentUpgrade.ps1 script.

1E-Explorer-TachyonAgent-UpgradeAgent

29