ThinPrint Management Services

Description

Defines a model for ThinPrint Connection Service Ports¹. The model is represented by a container that predefines all printer ports to be installed by Tpms.Agent in one variable.

Afterwards, this model can be used to define the target machine using New-TpmsObjApplyAgent and to perform the installation process using Start-TpmsApplyByAgent.

Requirements

• ThinPrint Engine
• Connection Service
• ThinPrint Clients (TCP/IP type)

TCP port directions with Connection Service printing

Syntax

New-TpmsObjTpPortCon -Name <string> -ConnectionService <string> -TcpPort <uint16> [-BandwidthCtrl <uint32>] [-IsEncrypted <boolean>] [-Compression <CompressionOpt>] [-PackageSize <uint32>] [-Scheme <SchemeVersion>] [-Version <uint32>]

ClientId:PrinterId#PrinterName

PrinterName#ClientId:PrinterId

ThinPrint Port settings: Connection Service port type (Con)

ThinPrint Port settings: Naming convention

Example 1: cmdlet usage

New-TpmsObjTpPortCon -ConnectionService "192.168.149.21" '
-TcpPort 4000 '
-BandwidthCtrl 500 '
-IsEncrypted 0 '
-Compression Default '
-Name Con:

Defines a ThinPrint Port with the denomination Con:, the print protocol Connection Service with the TCP port 4000, bandwidth limited to 500 kbit/s (kbps), no encryption and the default compression level.

Example 2: Script containing New-TpmsObjTpPortCon (for Native Printing)

The following script creates and shares a number of ThinPrint printers with native drivers – each with a Thin­Print Connection Service Port – here, with unlimited bandwidth. The printer information is retrieved from a specific ThinPrint Client via the Connection Service. The printer properties are retrieved from the templates of the relevant native drivers.

For each printer retrieved from the ThinPrint Client a relevant ThinPrint printer with a native driver as well as a ThinPrint Port is created.

$allports = @()

$printers = @()

$allprinters = @()

$client = New-TpmsObjTpClient -Name "192.168.149.21" -Port 4000 -Uidx 88

$srva = New-TpmsObjQueryAgent -Name "cps47.ourdomain.local" -Port 5050 -ClientQueries ($client)

$printerlists = Start-TpmsQueryByAgent -Servers ($srva) | Format-TpmsDispatch

$portnum = 0

$printerlists | foreach {

if ($_ -is [ThinPrint.Tpms.Common.TpSrcPrn])

{

$printer = $_.Name

$printerid = $_.Id

$printers = New-TpmsObjPrinter -Name ([string]::Format("{0}#88:{1}", $printer, $printerid)) -Port ([string]::Format("ThinPort{0:D3}:", $portnum)) -Driver $_.DrvName -Template $_.DrvName

Add-TpmsSharingInfo -Printers ($printers) -Name $_.Name -Mode Network

$allprinters += $printers

$allports += New-TpmsObjTpPortCon -ConnectionService "192.168.149.21" -TcpPort 4000 -Name ([string]::Format("ThinPort{0:D3}:", $portnum))

$portnum += 1

}

else

{

$_

}

}

$srvb = New-TpmsObjApplyAgent -Name "cps47.ourdomain.local" -Port 5050 -Printers ($allprinters) -Ports ($allports)

Start-TpmsApplyByAgent -Action Deploy -Servers ($srvb) | Format-TpmsDispatch

Start-TpmsApplyByAgent -Action Deploy creates ports and printers on the target machine and -Action Remove deletes them.

Note! Always run Add-TpmsSharingInfo together with New-TpmsObjPrinter or New-TpmsObjPrinterTpog – i. e., not with separate scripts.

ThinPrint Client with ID 88 connected to the Connection Service (running on 192.168.149.21)

Printers folder on the central print server: template printers before running the script

printers in the ThinPrint Client Manager of client with ID 88

Printers folder on the central print server: template printers as well as four ThinPrint printers (with native drivers) created and shared by the script above

ThinPrint Port Manager: template printers connected to ThinPort: as well as ThinPrint printers connected to four ThinPrint Connection Service Ports created by the script above

^{1 Print data are sent – bandwidth controlled and compressed – via the Connection Service to ThinPrint Clients}