Skip to main content

1E SDK

Tachyon Agent Methods

Alphabetic listing of Agent methods. Under this page are separate pages with full details for each function.

Note

This documentation refers to the Tachyon Agent, which is the old name for Tachyon client features of the 1E Client. In Tachyon 4.1 the Tachyon Agent was renamed as the 1E Client, which also provides client modules for Nomad, PXE Everywhere, Shopping/WSA, and WakeUp. The Nomad client module has some methods available for use in SCALE also documented here.

Note

The names of modules and methods, and the names of their parameters, are case-sensitive.

A module library is represented by a file in the Agent installation Extensibility folder called Tachyon.<module>.library.dll or Tachyon.<module>.library.so depending on the O/S.

Please refer to the parent page Functions and Methods Reference to know the earliest version of the Agent in which a method was implemented, and which platforms they are supported.

Modules

Agent module
  • Agent.CheckForUpdates— Check whether extensibility (module and provider) updates are available, and if so to download and install them.

  • Agent.Echo— Return the specified text.

  • Agent.GetConnectionInformation— Returns Switch connection and Background Channel information.

  • Agent.GetDiagnostics— Uses 1E Client performance counters to get various stats.

  • Agent.GetExtensibility— Get the list of extensibility modules and providers currently loaded by the agent.

  • Agent.GetInstructionStatistics— Returns execution statistics for instructions that the agent has processed since the last time it was started/restarted.

  • Agent.GetKeyFiles— Returns names and paths of key files relating to the execution of the Tachyon Agent.

  • Agent.GetSummary— Returns high-level information about the device the Agent is running on.

  • Agent.Log— Write a message to the Tachyon Agent log file.

  • Agent.Sleep— Pause for the specified number of seconds.

  • Agent.Stagger— Delay for a random amount of time up to a limit.

ContentDistribution module
Device module
Discovery module
FileContent module
FileSystem module
Http module
  • Http.Post— Send the supplied Body text via a HTTP request to the specified Uri endpoint to consume and return the response if completed. This Method is primarily for use with Splunk Event Collectors, but it might support other similar Web APIs.

Interaction module
Inventory module

Other methods used by the Tachyon Activity Record feature are not exposed for use in SCALE.

Mobile module
NativeServices module
Network module
Nomad module
  • Nomad.CachedPkgStatus— Get the percentage of the specified content in the local Nomad cache.

  • Nomad.CancelJob— Cancels download job with the given ID and removes it from Nomad’s job queue.

  • Nomad.FindBestPkgCache— Find the device that has the greatest percentage of the specified content in its Nomad cache.

  • Nomad.GetCachedPkgDetails— Gets details about a package cached in Nomad.

  • Nomad.GetCachePath— Gets the path on disk where Nomad’s cache is located.

  • Nomad.GetCmContentLocations— Find the Configuration Manager locations (on distribution points - DPs) that have the specified content.

  • Nomad.GetVariable— Gets the value of the given Nomad "variable".

  • Nomad.JobsStatus— List active Nomad jobs.

  • Nomad.Pause— Pause any currently-executing Nomad job. Has no effect if no job is currently running.

  • Nomad.PauseJobQueue— Pause the Nomad job queue so that no jobs will run.

  • Nomad.Resume— Resume any currently-paused Nomad job. Has no effect if no job is currently paused.

  • Nomad.ResumeJobQueue— Resume the currently-paused Nomad job queue. Has no effect if the job queue is not currently paused.

  • Nomad.RunPkgStatusRequest— Test whether any other SSD (single site download) device has more content than the local Nomad cache.

  • Nomad.RunSsdQuery— Use Nomad's SSD (single site download) feature to find on which devices the specified content is cached.

  • Nomad.Status— Get the status and version of the Nomad service.

  • Nomad.Stop— Stop any currently-executing Nomad job. Has no effect if no job is currently running.

OperatingSystem module
Patch module
  • Patch.Deploy— Deploy (i.e. download and by default install) either all available patches or specific patches to this device.

  • Patch.GenerateFullInventoryEvents— Generate Full Inventory Events

  • Patch.GetMetadata— Query metadata for a single patch or comma-separated list of patches.

  • Patch.GetStatus— Report how updates are configured for the device.

  • Patch.List— List the status of patches.

  • Patch.Restart— Microsoft-suggested procedure to fix Windows Update Agent problems, which has optional steps that include a restart of the Windows Update service.

  • Patch.TestConnection— Check that the source for patches is accessible.

Policy module
Scripting module
Security module
Shopping module

No methods in this module are exposed for use in SCALE.

Software module
Storage module
  • Storage.Check— Tests the existence of a user defined persistent storage table.

  • Storage.Delete— Removes an existing user defined persistent storage table.

  • Storage.Get— Indicate whether a persistent storage table of the specified name is present and return its contents if present.

  • Storage.GetRemote— Retrieve the requested datum directly from the Platform central repository.

  • Storage.List— Enumerates all user-defined persistent storage tables.

  • Storage.Set— Set or change the value of the named persistent storage table.

Tagging module
  • Tagging.Check— Tests the existence of a named tag of a specified type, optionally with the specified value.

  • Tagging.Clear— Delete all tags of the specified type.

  • Tagging.Count— Get the quantity of tags of the specified type.

  • Tagging.Delete— Delete the named tag of the specified type, and indicate if it originally existed.

  • Tagging.Get— Indicate whether a named tag of the specified type is present and return its value if present.

  • Tagging.GetAll— Fetch the tag list (containing all tags) of the specified type.

  • Tagging.Set— Set (or change if already set) the named tag of the specified type to the specified value.

Users module
Utilities module
  • Utilities.GenerateSequence— Build a sequence of numeric values, starting at 1 up to and including the value of a specified limit.

  • Utilities.JsonFromTable— Serializes a table variable into a JSON string

  • Utilities.SplitLines— Convert a delimited fragment of text into multiple rows.

  • Utilities.TableFromJson— Deserializes a correctly escaped JSON string that represents a two dimensional set of data with consistent columns and rows into a table variable.

WakeUp module

No methods in this module are exposed for use in SCALE.