Freigeben über


POSDM-Befehle (POS für .NET v1.14 SDK-Dokumentation)

POSDM verwendet die folgenden Befehle.

Befehl

Beschreibung

Syntax und Beispiele

adddevice

Fügt ein physisches, nicht Plug & Play-fähiges Gerät hinzu.

posdm [general switches] adddevicepath filter[/info]

wobei path ein Hardwarepfad des physischen Geräts ist,

filter kann mindestens eins der folgenden Elemente sein:

/type:devicetype

/soname:soname

und

„/info“ ist ein Schalter, der alle Geräteeigenschaften anzeigt.

Beispiel:

posdm adddevice COM3 /soname:MsrSimulator

Dadurch wird dem MsrSimulator-Dienstobjekt ein Gerät mit dem Hardwarepfad COM3 hinzugefügt.

addname

Fügt einem Gerät einen logischen Namen hinzu.

posdm [general switches] addnamedevicenamefilter

wobei devicename der logische Name ist, der dem Gerät zugewiesen werden soll, und filter mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Beispiel:

posdm addname MainMSR /type:MSR /path:COM3

Dadurch wird der logische Name MainMSR für das MSR-Gerät im COM3-Hardwarepfad hinzugefügt.

posdm addname BackupMSR /name:MainMSR

Dadurch wird der logische Name BackupMSR für das Gerät namens MainMSR hinzugefügt.

addproperty

Fügt einem Gerät eine Konfigurationseigenschaft hinzu.

posdm [general switches] addpropertypropertyname value filter[/info]

wobei propertyname der Name der Eigenschaft und value der Anfangswert für diese Eigenschaft ist, und filter ist mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

„/info“ ist ein Schalter, der alle Geräteeigenschaften anzeigt.

Beispiel:

posdm addproperty PrintSpecialGreeting "Happy New Year!" /name:MainMSR

Dadurch wird dem Gerät namens MainMSR die Eigenschaft PrintSpecialGreeting mit dem Wert „Happy New Year!“ hinzugefügt.

deletedevice

Löscht ein physisches, nicht Plug & Play-fähiges Gerät.

posdm [general switches] deletedevice[path] filter

wobei „filter“ mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

Beispiel:

posdm deletedevice COM3 /type:Msr

Dadurch wird das MSR-Gerät im Hardwarepfad COM3 gelöscht.

Nur Geräte, die zuvor mit dem Befehl adddevice hinzugefügt wurden, können gelöscht werden.

deletename

Löscht einen logischen Namen aus der Liste der Namen eines Geräts.

posdm [general switches] deletename devicenamefilter [/info]

wobei filter mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

und

„/info“ ist ein Schalter, der alle Geräteeigenschaften anzeigt.

Beispiel:

posdm deletename "Main Scanner" /type:Scanner /path:COM3

Dadurch wird der logische Name „Main Scanner“ (Hauptscanner) für das Scannergerät im COM3-Pfad gelöscht.

Nur logische Namen, die zuvor durch den Befehl addname hinzugefügt wurden, können gelöscht werden.

deleteproperty

Löscht eine Konfigurationseigenschaft eines Geräts.

posdm [general switches] deletepropertypropertyname filter [/info]

wobei „filter“ mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

und

„/info“ ist ein Schalter, der alle Geräteeigenschaften anzeigt.

posdm deleteproperty PrintSpecialGreeting /name:MainMSR

Dadurch wird die Eigenschaft PrintSpecialGreeting des Geräts namens MainMSR gelöscht.

Nur Konfigurationseigenschaften, die zuvor durch den Befehl addproperty hinzugefügt wurden, können gelöscht werden.

disable

Verhindert, dass ein Dienstobjekt für ein physisches POS-Gerät ausgeführt wird.

posdm [general switches] disablefilter

wobei „filter“ mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Beispiel:

posdm disable /name:ReceiptPrn

Dadurch wird verhindert, dass ein Dienstobjekt für ein Gerät namens ReceiptPrn ausgeführt wird. Daher wird das Gerät für Anwendungen nicht in der Liste der verfügbaren POS-Geräte angezeigt.

enable

Gestattet die Ausführung eines Dienstobjekts für ein physisches POS-Gerät.

posdm [general switches] enablefilter

wobei filter mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Beispiel:

posdm enable /type:MSR

Dadurch wird die Ausführung eines Dienstobjekts für alle MSR-Geräte gestattet.

info

Zeigt Informationen zum Gerät an, einschließlich seiner Konfigurationseigenschaften.

posdm [general switches] infofilter

wobei „filter“ mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Beispiel:

posdm info /name:MSR1

Dieser Befehl zeigt Informationen zu einem Gerät mit dem logischen Namen „MSR1“ an.

listdevices

Listet die physischen POS-Geräte auf.

posdm [general switches] listdevices [/type:devicetype]

wobei der Schalter /type:devicetype die Liste auf einen bestimmten Gerätetyp einschränkt.

Beispiele:

posdm listdevices

Dadurch wird eine Liste aller physischen POS-Geräte angezeigt, die auf dem lokalen Computer installiert sind.

posdm listdevices /type:MSR

Dadurch wird eine Liste aller MSR-Geräte angezeigt, die auf dem lokalen Computer installiert sind.

posdm /machine:Center10 /username:JohnDoe3 /password:B$tg59ce listdevices

Dadurch werden alle physischen POS-Geräte aufgelistet, die auf dem Computer namens „Center10“ installiert sind, nachdem die Anmeldung mittels Anmeldeinformationen mit Benutzername und Kennwort erfolgt ist.

listnames

Listet die logischen Namen auf, die POS-Geräten zugeordnet sind.

posdm [general switches] listnames filter

wobei filter mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

Beispiel:

posdm listnames /type:MSR /path:COM3

Dadurch wird eine Liste der Namen angezeigt, die dem MSR-Gerät unter COM3 zugeordnet sind.

listprops

Listet die Konfigurationseigenschaften auf, die einem POS-Gerät zugeordnet sind, und deren Werte.

posdm [general switches] listpropsfilter

wobei „filter“ mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Beispiel:

posdm listprops /type:MSR /path:COM3

Dadurch wird eine Liste der Eigenschaftsnamen und Werte angezeigt, die dem MSR-Gerät unter COM3 zugeordnet sind.

listsos

Listet die POS-Dienstobjekte auf dem Zielcomputer auf.

posdm [general switches] listsos [/type:devicetype]

wobei der Schalter /type:devicetype die Liste auf einen bestimmten Gerätetyp einschränkt.

Beispiele:

posdm /output:a:\solist.txt listsos

Dadurch wird eine Liste aller auf dem lokalen Computer installierten Dienstobjekte in eine Datei namens „solist.txt“ auf Laufwerk A geschrieben.

posdm listsos /type:MSR

Dadurch wird eine Liste aller Dienstobjekte angezeigt, die MSR-Geräten auf dem lokalen Computer zugeordnet sind.

posdm /machine:Center10 /username:JohnDoe3 /password:B$tg59ce listsos

Dadurch werden alle Dienstobjekte auf dem Computer namens „Center10“ aufgelistet, nachdem die Anmeldung mittels Anmeldeinformationen mit Benutzername und Kennwort erfolgt ist.

setdefault

Legt ein Gerät als Standard seines Typs (type) fest.

Das Standardflag weist die PosExplorer.GetDevice(type)-Methode an, dieses Gerät selbst dann zurückzugeben, wenn mehr als ein Gerät dieses Typs verfügbar ist.

posdm [general switches] setdefault ON|OFF filter [/info]

wobei filter mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Der Schalter „/info“ bewirkt, dass alle Geräteeigenschaften angezeigt werden.

Beispiel:

posdm setdefault ON /name:FirstScanner

In diesem Beispiel wird FirstScanner als diejenige bestimmt, der von der CCL-Geräteenumeration gefunden wird.

setpath

Legt den POS-Gerätepfad für nicht Plug & Play-fähige Geräte fest.

posdm [general switches] setpath hardware_path filter

wobei filter mindestens eins der folgenden Elemente ist, die erforderlich sind, um ein Gerät eindeutig zu identifizieren:

/type:devicetype

/soname:soname

/path:hardware_path

/name:devicename

Beispiel:

posdm setpath COM2 /type:MSR

Dadurch wird der Hardwarepfad für MSR-Geräte auf COM2 festgelegt.

Der Befehl setpath funktioniert nur für nicht Plug & Play-fähige Geräte, die zuvor mit dem Befehl adddevice hinzugefügt wurden.

Weitere Informationen

Konzepte

Weitere Ressourcen