Beispiel 1: Gebrauch des Cmdlets
Beispiel 3: Skript mit dem Cmdlet New-TpmsObjTpPortTcp (für Native Printing)
Beschreibung
Definiert ein Modell für einen ThinPrint Port vom Typ TCP/IP1. 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.
Hinweis! Beachten Sie bitte auch den Abschnitt Drucker mit ThinPrint Ports verbinden.
Voraussetzungen
- ThinPrint Engine
- ThinPrint Clients (TCP/IP-Typ)
ThinPrint-TCP/IP-Drucken: Weg der Druckdaten zu lokalen Druckservern oder Gateway-Appliances
ThinPrint-TCP/IP-Drucken: Weg der Druckdaten zu Workstations oder Thin-Clients
Syntax
New-TpmsObjTpPortTcp -Name <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: TcpIpPort: oder "TcpIp Port:" |
-TcpPort | TCP-Port für die Verbindung zum ThinPrint Client (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} |
-PackageSize | IP-Paket-Größe (in Byte) beim Senden zu ThinPrint Clients (Standardwert: 65535) |
-Scheme | Alt: Druckernamen-Konvention ClientAddress:PrinterId#PrinterName Neu: Druckernamen-Konvention PrinterName#ClientAddress:PrinterId (Standardwert) siehe Namenkonvention |
-Version | Version des ThinPrint-Port-Monitors (Standardwert 151257685). Bei Tpms-Version 1.0 muss dieser Parameter angegeben werden, ab Tpms-Version 1.2 nicht mehr. Versionsnummer für ThinPrint Engine 12: 201326598 |
ThinPrint-Port-Einstellungen: Port-Typ TCP/IP (sockets)
ThinPrint-Port-Einstellungen: Namenkonvention
Beispiel 1: Gebrauch des Cmdlets
Das folgende Beispiel definiert einen ThinPrint Port mit der Bezeichnung Tcp:, mit dem Druckprotokoll ThinPrint TCP/IP und dem TCP-Port 4000, mit einer Bandbreitenbegrenzung auf 256 kbit/s, ohne Verschlüsselung, der Komprimierungsstufe 5 und einer IP-Paket-Größe von 128 KByte. Diese Einstellungen werden in die Variable $port geschrieben.
Siehe auch New-TpmsObjApplyAgent für Informationen zur Nutzung der Variable $port.
$port = New-TpmsObjTpPortTcp -Name Tcp: -TcpPort 4000 -BandwidthCtrl 256 -IsEncrypted 0 -Compression Level5 -PackageSize 131071
Beispiel 2: Skript mit dem Cmdlet New-TpmsObjTpPortTcp (zum Anlegen von ThinPrint Ports ohne Drucker oder Treiber)
Das folgende Skript legt mehrere ThinPrint Ports an. Die Anzahl der Ports kann mit der Variable $portnumber festgelegt werden und der Portname mit $portname. Die Optionen Bandbreite und Verschlüsselung können zusätzlich angegeben werden.
Die Adresse des Zielrechners muss mit der Variable $servername abgegeben werden.
$servername = "cps47.ourdomain.local" $portname = "Paris" $portnumber = 2 $encrypted = 0 $bandwidth = 256 $ports = @() For($j=0; $j -lt $portnumber; $j+=1){ $ports += New-TpmsObjTpPortTcp -TcpPort 4000 -Name ([string]::Format("{0}{1:D3}:", $portname, $j)) -IsEncrypted $encrypted -BandwidthCtrl $bandwidth } $srv = New-TpmsObjApplyAgent -Name $servername -Port 5050 -Ports ($ports) Start-TpmsApplyByAgent -Action Deploy -Servers ($srv) | Format-TpmsDispatch
Start-TpmsApplyByAgent -Action Deploy legt die Ports Paris000 und Paris001 sowie Drucker auf dem Zielrechner an, und -Action Remove löscht sie.
zwei ThinPrint Ports auf cps47.ourdomain.local anlegen
Beispiel 3: Skript mit dem Cmdlet New-TpmsObjTpPortTcp (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 TCP/IP. Die Drucker-Liste wird von einem ThinPrint Client eingelesen, der auf client701 läuft. 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. Die Verschlüsselung wird in der Konfiguration des ThinPrint Ports aktiviert.
$allports = @() $printers = @() $allprinters = @() $client = New-TpmsObjTpClient -Name client701 -Port 4000 $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}#client701:{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-TpmsObjTpPortTcp -TcpPort 4000 -Name ([string]::Format("ThinPort{0:D3}:", $portnum)) -IsEncrypted 1 $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.
Drucker im ThinPrint Client Manager auf client701
Druckerordner auf dem zentralen Druckserver: Template-Drucker vor dem Ausführen des Skriptes
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 Ports vom Typ TCP/IP – angelegt durch das obige Skript
1 Druckdaten werden – bandbreitenbegrenzt und komprimiert – direkt zu ThinPrint Clients über das ThinPrint-TCP/IP-Protokoll gesendet.