Beschreibung
Definiert ein Modell für einen ThinPrint Connection Service Port 1 . Das Modell stellt einen Container dar, der alle vom Tpms.Agent zu installierenden ThinPrint Ports in einer Variablen vordefiniert.
Anschließend kann diese Modell verwendet werden, um den Zielrechner mit Hilfe von New-TpmsObjApplyAgent festzulegen und den Installationsprozess mit Start-TpmsApplyByAgent zu starten.
Voraussetzungen
- ThinPrint Engine
- Connection Service
- ThinPrint Clients (TCP/IP-Typ)
Richtungen der TCP Ports beim Drucken via Connection Service
Syntax
New-TpmsObjTpPortCon -Name <string> -ConnectionService <string> -TcpPort <uint16> [-BandwidthCtrl <uint32>] [-IsEncrypted <boolean>] [-Compression <CompressionOpt>] [-PackageSize <uint32>] [-Scheme <SchemeVersion>] [-Version <uint32>]
| Parameter | Beschreibung |
| -Name | Bezeichnung des Drucker-Ports; siehe Port name; der Port-Name muss mit einem Doppelpunkt enden ( : ), Beispiele:
CsPort: oder “Cs Port:” |
| -ConnectionService | Adresse des Servers, auf dem der Connection Service läuft; siehe Connection Service address |
| -TcpPort | TCP-Port für Verbindung zum Connection Service (Standardwert: 4000); siehe TCP-Port |
| -BandwidthCtrl | Bandbreite für das Drucken begrenzen auf 1–10,000 kbit/s (kbps); Standardwert: unbegrenzt; siehe Bandwidth control
Bis einschließlich Installer-Version 1.0.53 bzw. 1.0.61 musste der Wert in bit/s anstelle von kbit/s angegeben werden. |
| -IsEncrypted | aktiviert die SSL-Verschlüsselung (Standardwert: 0)
1: aktiviert 0: deaktiviert |
| -Compression | Stärke der Komprimierung
{Disabled | Level0 | Level1 | BestSpeed | Level2 | Level3 | Level4 | Level5 | Level6 | Default | Level7 | Level8 | Level9 | BestCompression} Für Level9 siehe Minimum print data volume |
| -PackageSize | IP-Paket-Größe (in Byte) beim Senden zu ThinPrint Clients (Standardwert: 65535) |
| -Scheme | Old: Druckernamen-Konvention ClientAddress:PrinterId#PrinterName
New: Druckernamen-Konvention PrinterName#ClientAddress:PrinterId (Standardwert) siehe Namenkonvention |
| -Version | optional: Version des ThinPrint-Port-Monitors (Standardwert: 151257685) |
ThinPrint-Port-Einstellungen: Port-Typ Connection Service (Con)
ThinPrint-Port-Einstellungen: Namenkonvention
Beispiel 1: Gebrauch des Cmdlets
New-TpmsObjTpPortCon -ConnectionService "192.168.149.21" ' -TcpPort 4000 ' -BandwidthCtrl 500 ' -IsEncrypted 0 ' -Compression Default ' -Name Con:
Das Skript definiert einen ThinPrint Port mit der Bezeichnung Con:, dem Druckprotokoll Connection Service mit dem TCP-Port 4000, mit der Bandbreite 500 kbit/s (kbps), der Standardkomprimierung und ohne Verschlüsselung.
Beispiel 2:
Skript mit dem Cmdlet New-TpmsObjTpPortCon (für Native Printing)
Das folgende Skript legt mehrere ThinPrint-Drucker mit nativen Treibern an und gibt diese frei – alle verbunden mit einem ThinPrint Port vom Typ Connection Service – hier mit unbegrenzter Bandbreite. Die Drucker-Liste wird von einem ThinPrint Client via Connection Service eingelesen. Die Drucker-Eigenschaften werden von den Templates der betreffenden nativen Treiber auf die Drucker übertragen.
Für jeden Drucker, der vom ThinPrint Client eingelesen wurde, wird ein ThinPrint-Drucker mit nativem Treiber sowie ein ThinPrint Port angelegt.
$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 legt Ports und Drucker auf dem Zielrechner an, und -Action Remove löscht sie.
Hinweis! Verwenden Sie Add-TpmsSharingInfo stets zusammen mit New-TpmsObjPrinter oder New-TpmsObjPrinterTpog – d. h. nicht in separaten Skripten.
ThinPrint Client mit der ID 88 verbunden mit dem Connection Service (der auf 192.168.149.21 läuft)
Druckerordner auf dem zentralen Druckserver: Template-Drucker vor Ausführung des Skriptes
Drucker im ThinPrint Client Manager des Clients mit der ID 88
Druckerordner auf dem zentralen Druckserver: Template-Drucker sowie vier ThinPrint-Drucker (mit nativen Treibern) angelegt und freigegeben mit dem obigen Skript
ThinPrint Port Manager: Template-Drucker verbunden mit ThinPort: sowie ThinPrint-Drucker verbunden mit vier ThinPrint Connection Service Ports – angelegt durch das obige Skript
1 Druckdaten werden – bandbreitenbegrenzt und komprimiert – via Connection Service zu ThinPrint Clients gesendet.