Open navigation

ezeep Hub PowerShell

It is very simple to administer the ezeep hub using powershell. Just follow the steps below:

  1. Install ezeep PowerShell Module
  2. Initialize ezeep Hub
  3. List of available cmdlets
  4. Remote powershell configuration

1. Install ezeep PowerShell Module

 Downloading module from the ezeep Hub and install on a windows machine that can access the hub locally.

  • Access the ezeep hub console and download the PowerShell module TPHubPS.dll from the ezeep hub console login page. 

Note: If you do not know the hub URL, then follow this link: Finding the ezeep Hub in the networkezeep hub powershell

  • The module will download to your default "Downloads" Folder. 
  • Open the TPHubPS.dll file’s properties and check or click on UNBLOCK  to lift Windows’ automatic blocking of copied DLLs. Click OK to con­firm.
  • Open Windows PowerShell as administrator, and run the command below to import the TPHubPS.dll mod­ule.

Import-Module .\TPHubPS.dll

2. Initialize ezeep Hub

Initialize the hub to be able to use all cmdlets with a specific Hub. Run the commands below:

# Specifying the URL of the target Hub

         Set-TPHubUri -Uri https://192.168.x.x

# Accepting the web console’s certificate by the PowerShell module

         Set-TPHubServerCertificateValidation -Option AcceptAlways

# Specifying the password of the target Hub (by default the password is print

         Get-TPHubAuthentication -PlainPassword print4life

3. List of available cmdlets

The following is an overview of the Hub’s PowerShell commands. 

  • The available cmdlets can be viewed using:

Get-Command -Module TPHubPS

Available cmdlets for:

  • Printers
    • Find Printers
    • Global SNMP Settings
  • Network Settings 
    • Hub Monitoring
    • Cloud Connect
    • Remote Management (Firmware 1.16+)
  • Pull Printing (Firmware 1.16+)
  • Certificates
  • System
    • Restart, Reset & Backup
    • Version Information & Update
    • System Time & Logging


Printers

CmdletBrief description
Get-TPHubPrinterRetrieves the printer list
Add-TPHubPrinterCreates a new printer
Set-TPHubPrinterModifies an existing printer
Get-TPHubAvailableUSBImports the printers connected to the USB interfaces
Remove-TPHubPrinterRemoves a printer from
Remove-TPHubAllPrinterRemoves all printers
Get-TPHubDefaultPrinterReads the default (or the current) printer
Set-TPHubDefaultPrinterSets the default (or the current) printer

Find Printers

CmdletBrief description
Set-TPHubFindPrintersSettingsEnables the search for printers in the local subnet of the hub and the automatic addition of found printers to the printer list
Get-TPHubFindPrintersSettingsDisplays the settings whether to search for printers in the local subnet of the hub and whether these printers should be automatically added to the printer list
Get-TPHubFindPrintersSearches for printers in the Hub’s local subnet
Set-TPHubDiscoveredPrinterEnables searching printers in the Hub’s local subnet
Get-TPHubDiscoveredPrinterSearches for printers in the Hub’s local subnet
Add-TPHubDiscoveredPrinterBlacklistMarks printers as hidden
Remove-TPHubDiscoveredPrinterBlacklistRemoves the attribute hidden

Global SNMP Settings

CmdletBrief description
Get-TPHubSnmpGlobalReads the SNMP configuration with which the printers are addressed
Set-TPHubSnmpGlobalSelects and configures SNMP protocol with which the printers are addressed
Get-TPHubPrinterSnmp
Set-TPHubPrinterSnmp
Get-TPHubPrinterSnmpStatus

Network Settings

CmdletBrief description
Get-TPHubNetworkDescReads the Hostname, Comments and Location description fields (and also the software internal Revision hash, to uniquely identify the configuration) from the Hub
Set-TPHubNetworkDescModifies the Hostname,Comments and Location description fields of the Hub
Get-TPHubNetworkIPV4Reads the Ipv4 configuration from the Hub
Set-TPHubNetworkIPV4Modifies the Hub’s IPv4 configuration
Set-TPHubNetworkIEEE802.1X

Sets the configuration for EAP network authentication for Ethernet

Get-TPHubNetworkIEEE802.1XReads the configuration of the EAP network authentication for Ethernet

Hub Monitoring

CmdletBrief description
Get-TPHubSnmpAgentV1
Set-TPHubSnmpAgentV1
Get-TPHubSnmpAgentV3
Set-TPHubSnmpAgentV3

Remote Management (Firmware 1.16+ only)

CmdletBrief description
Get-TPHubEzeepCloudManagementChecks the activation of the cloud management of ezeep Blue
Set-TPHubEzeepCloudManagementEnables cloud management of ezeep Blue (prerequisite for Hub claiming)

Cloud Connect

CmdletBrief description
Connect-TPHubEzeepConnects the Hub to ezeep Blue to allow printers installed on the  Hub to also be used for cloud printing with ezeep Blue
Get-TPHubEzeepDisplays the properties of the connection made with Connect-TPHubEzeep to ezeep Blue
Disconnect-TPHubEzeepDisconnects the Hub from ezeep Blue

Pull Printing (Firmware 1.16+ only)

CmdletBrief description
Get-TPHubPPConfigurationDisplays the Pull Printing settings
Set-TPHubPPConfigurationSets specific Pull Printing properties
Get-TPHubPPServerCheckTests the connection to the Pull Printing server.
Get-TPHubPPReaderShows the current assignment of the card reader to the USB interface(s)
Set-TPHubPPReaderThis cmdlet allows you to manually assign the card readers to the USB interfaces. Automatic recognition of the USB port assignment is only possible with the web con­sole.
Get-TPHubPPLastIdDisplays the identification number (ID) of the last card held to the card reader and the date and time of this event.
Get-TPHubPullPrintingConfigurationReads the Pull Printing configuration for ezeep Blue
Set-TPHubPullPrintingConfigurationSets and configures pull printing for ezeep Blue

Certificates

CmdletBrief description
Add-TPHubCertificateUploads a certificate onto the Hub
Unlock-TPHubCertificateIf a certificate (just) loaded, with Add-TPHubCertificate, is protected by a password, then unlock it with this Cmdlet.
Get-TPHubUnconfirmedCertificateThis function can be used to check whether a password-protected certificate has been successfully unlocked with Unlock-TPHubCertificate after uploading
Remove-TPHubUnconfirmedCertificateThis Cmdlet has the same function as the Remove . It can only be used following the uploading of a certificate whose password has still not been sent to the Hub with Unlock-TPHubCertificate.
Remove-TPHubCertificateRemoves certificates that are not currently assigned a function with Set-TPHubSsl­Config
Get-TPHubCertificateDisplays all the certificates uploaded with Add-TPHubCertificate – regardless of whether they have already been assigned a function with Set-TPHubSslConfig
Get-TPHubSslConfigIndicates what function has been assigned to which certificate uploaded with Add-TPHubCertificate
Set-TPHubSslConfigApplies one of three functions to certificates uploaded with Add-TPHubCertificate

System

CmdletBrief description
Find-TPHubDevicesSearches for Hubs in the local subnet
Set-TPHubTemporaryNetworkConfigChanges the IP address of a Hub (valid only up to the next system reboot of the device).
Set-TPHubUriDefines web address of the Hub to be configured
Get-TPHubUriShows the current web address of the Hub to be configured
Set-TPHubProxyDefines a proxy server for web access to the Hub to be configured
Get-TPHubProxyDisplays the current proxy server address
Set-TPHubServerCertificateValidationDetermines whether or not the web console certificate will be accepted by the Pow­erShell module
Get-TPHubServerCertificateValidationImports the current setting for accepting the web console certificate through the Pow­erShell module
Get-TPHubLanguageReads the current system language
Set-TPHubLanguageChanges the system language back
Set-TPHubPasswordChanges the system password
Get-TPHubIsHiddenShows whether the function Make Hub invisible for the Hub Finder is enabled, i. e. whether the Hub will become invisible to the Finder after five minutes
Set-TPHubIsHiddenAfter five minutes after a system reboot, the Hub will no longer appear in the Hub Finder
Get-TPHubAuthenticationLogs the current user into the Hub
Clear-TPHubAuthenticationLogs the current user out from the Hub

Restart, Reset & Backup

CmdletBrief description
Start-TPHubRebootReboots the system
Start-TPHubFactoryResetResets the Hub to its factory default settings
Get-TPHubRequestTimeoutReads the timeout from the Hub
Set-TPHubRequestTimeoutReads the timeout from the Hub
Export-TPHubBackupSaves the settings in a .json file
Import-TPHubBackupReads the saved settings from the .json backup file and writes them into the Hub
Get-TPHubTaskResult

Version Information & Update

CmdletBrief description
Get-TPHubVersionsReads out the version information
Update-TPHubFirmwareUpdates the firmware

System Time & Logging

CmdletBrief description
Get-TPHubTimeReads the Hub’s system time
Set-TPHubTimeSets the system time if a time server is not specified and there is no internet connec­tion
Get-TPHubTimeServerSends query to time server in the Hub
Set-TPHubTimeServerDefines a time server
Export-TPHubLogFileSaves the logs completely into a file
Get-TPHubLogVerbosityRetrieves the log level
Set-TPHubLogVerbosityModifies the  log level
Clear-TPHubLogFileRemoves all log files
Get-TPHubRemoteSyslogAddressReads the address of the syslog server
Set-TPHubRemoteSyslogAddressSets the address of the syslog server


The ezeep Hub can also be controlled remotely (via the cloud).


  • Copy to your PC and unzip the package
  • Get the mac address of the hub (e.g. b8:27:eb:2f:7a:a1) 
  • Start Powershell and run the following commands:
    Import-Module .\TPHubPS.dll 

    Set-TPHubServerCertificateValidation -Option AcceptAlways 

    Add-TPHubClaimEzpHub -Serial <hub mac> 

    Get-TPHubAuthentication -PlainPassword print4life -ConnectorSerial <hub mac>

Now all hub powershell commands from the above table are available for normal use. 



Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.