Skip to main content

1E 8.1 (on-premises)

1E PowerShell Toolkit release notes

These notes contain information about the toolkit at the time it was released.

Online help

Tachyon has online help that shows you how to install, configure and use the product.

For support queries, please:

New features
  • Works with Tachyon

  • Support for OAuth 2.0 - Azure Active Directory.

Release history

Version 1.2.4 (web release 8-JUNE-2023)

  • Removed quotes around the 'exp' and 'iat' properties of a created JWT. While these JWTs are accepted by most identity providers, PingFederate rejects them with quotes. They should be integer values, unquoted. This is compliant with the appropriate standard and accepted by all IdPs.

  • Added -UseBasicParsing to all uses of invoke-webrequest. Previously, only some invocations had this parameter added. This avoids an error when run on systems that have never had Internet Explorer installed.

  • Modified the get-1eeventsource cmdlet to accept an optional Id parameter.

  • Modified the add-1eeventsubscription cmdlet to accept an optional SourceId parameter.

  • Added new cmdlets add-1eeventsource, remove-1eeventsource and update-1eeventsource.

Version 1.2.3 (web release 07-MAR-23)

  • Changed the status check for retrieving instruction results so that an instruction which has been cancelled (and is in the 'cancelling' state) can still have results retrieved.

Version 1.2.2

  • Added convert-1eprincipal cmdlet

  • Added -PrincipalName parameter to update-1eprincipal cmdlet

Version 1.2.1

  • The get-1einstructioninset cmdlet now requests that all instructions, including server-side instructions, are retrieved. Previously, due to an API change, these instructions would not have been returned.

Version 1.2.0  (web release 15-FEB-23)

  • Files and cmdlet prefixes have been changed to reflect company rebranding and product renaming.

    • The Tachyon PowerShell Toolkit is now called 1E PowerShell Toolkit.

    • Cmdlets prefix is now 1E instead of Tachyon. For example, Set-1EServer instead of Set-TachyonServer.

    • For backwards compatibility, please refer to Compatibility with legacy scripts regarding how to reconfigure the new toolkit to use the Tachyon prefix.

    • Release history below retains the original cmdlet names.

  • A failure during non-interactive authentication is now reported as a thrown exception.

Version 1.1.46

  • DENY permission exists, but has never been supported. The Toolkit has been fixed so that it no longer allows DENY permission.

Version 1.1.45

  • Fix issue with get-tachyontriggertemplate -asxml where agent parameters are empty.

Version 1.1.44

  • Add support for Datadog integration.

Version 1.1.43 (web release 03-NOV-22)

  • Add get-tachyonrulehistory cmdlet.

Version 1.1.42

  • Add -metadataendpoint parameter to get-tachyonjwt cmdlet.

  • Add get-tachyonsignedjwt cmdlet.

Version 1.1.41

  • Add get-tachyonconnector cmdlet.

  • Add get-tachyonconnectortype cmdlet.

  • Add update-tachyonconnector cmdlet.

Version 1.1.40

  • Add -ReceivedOnly param to get-tachyonresultsacsvfile.

  • Change behaviour of received data logic so that if an instruction transitions to complete, then the final received count is taken as the total data set, even if statistics say more devices were targeted than responded. This prevents retry timeouts trying to return data from instructions that were launched from the UI, where the scope is dynamic and the statistics may never match up. Instructions launched from the toolkit use targeted FQDNs and are less likely to exhibit this issue.

Version 1.1.39

  • Add Move-TachyonInstruction cmdlet.

  • Support for OAuth interactive sign in.

Version 1.1.38

  • Add support for full rule modification in update-tachyonrule. It is now possible to update all rule components (or add or remove them), changing parameters if necessary.

Version 1.1.37

  • Add support for shared secret in get-tachyonbearertoken to support Ping identity provider.

Version 1.1.36

  • Fix issue in PowerShell Core where get-content -raw returns incorrect length for binary files, causing dynamic file copy to fail and new-tachyonresource to compute an incorrect length for binary resources.

Version 1.1.35

  • Support repeated trigger template Ids in add-tachyonrule.

Version 1.1.34

  • Get-PolicyRuleDeviceStatus - add -RuleId parameter to filter device compliance by rule.

  • Documentation – Using the Tachyon PowerShell Toolkit on non-Windows platforms.

Version 1.1.33

  • Add support for Accessing Certificates from the Azure Key Vault and Managing certificates with the Azure Credential Vault.

Version 1.1.32

  • Add support for certificate retrieval from keystore in Linux.

Version 1.1.31

  • Fix issue with JWT creation under PowerShell Core.

Version 1.1.30

  • Add functionality to create rules for Guaranteed State and update existing rules (partial functionality).

Version 1.1.29

  • Fix issue with certificate KID base 64 url encoding.

Version 1.1.28

  • Fix issue with raw HTTP requests when using override NTLM credentials.

Version 1.1.27

  • Fix variable misspelling that could cause Tachyon version not to be set when connecting.

Version 1.1.26

  • Add -name and -force params to get-tachyonprincipal and remove-tachyonprincipal.

Version 1.1.25

  • Support SID for legacy systems when adding principal; correct Okta scope issues.

Version 1.1.24

  • Add get-jwkfromcertificate cmdlet

Version 1.1.3

  • No functional changes.

  • Resolved an issue where values in scope expressions that contained reserved operators such as 'India' which contains the reserved operator 'in' were not parsed correctly, causing an error to be returned when these values were used in comparisons.

Version 1.1.2

  • No functional changes.

  • The Export-TachyonFragment cmdlet could return an error when invoked. It now correctly defaults the file extension on exported fragments to XML when no extension is provided.

  • The Export-TachyonPolicy cmdlet did not include override parameter values for fragments in the exported policy.

  • The Invoke-TachyonDynamic cmdlet, when used with the -Files option to copy files, did not correctly handle filenames with embedded spaces

Version 1.1.1 (web release 08-FEB-22)

  • No functional changes.

  • Cmdlets referencing Coverage tags now refer to Device tags (due to change in Tachyon 8.0).

  • Cmdlets referencing Scheduled tasks now refer to Schedules.

Version 1.1.0

  • Add -Credential parameter to set-tachyonserver cmdlet to allow alternate credentials to be supplied when connecting using Windows authentication.

Version 1.0.2

  • Add support for exporting Guaranteed State policies and their components in XML format and to create an integrated product pack ZIP file from a policy and its components.

  • Fix encoding issue when exporting fragments that contain non-ASCII unicode characaters.

  • Rename search-tachyonserver cmdlet to search-tachyoninstruction.

Version 1.0.1

  • Version 1.0.1 was an internal release only and was not distributed.

Version 1.0.0

  • Fix incorrect version prereq checking for Invoke-TachyonWMIQuery cmdlet.

  • Add check for proxy connection access denied error.

Version 0.8.24

  • Add support for scheduled tasks and conditional action scripts.

  • Add Get-TachyonInstructionResultFqdn cmdlet.

  • Add -Offload parameter to invoke-tachyoninstruction cmdlet.

Version 0.8.23

  • Add support for SLA management groups.

  • Add support for Experience surveys.

Version 0.8.22

  • Add support for Tachyon Proxy client certificate authentication.

Version 0.8.21

  • Add support for new v8 management group API to associate role/principal pairs with MGs

  • Reinstate add/remove role and add/remove permissions cmdlets now that MGs have been refactored.

Version 0.8.20

  • Add support for the Tachyon Proxy Server (proxy for Consumer Authentication).

Version 0.8.19

  • Add -Force parameter to invoke-tachyondynamic and new-tachyonresource cmdlets, to allow the remote device PowerShell execution policy to be overridden.

Version 0.8.17

  • Added -Csv parameter to Invoke-TachyonInstruction cmdlet.

Version 0.8.16

  • Added WMI cmdlet.

  • Added -Id and -Name parameters to Get-TachyonInstruction cmdlet.

  • Changed all online help examples to ensure that the Tachyon prefix was correctly included in cmdlet name.

Version 0.8.15

  • Added credential management cmdlets.