POSDM 命令 (POS for .NET v1.14 SDK 文件)
POSDM 使用下列命令。
命令 |
說明 |
語法和範例 |
adddevice |
新增非隨插即用的實體裝置。 |
posdm [一般參數] adddevicepath filter[/info] 其中 path 為實體裝置的硬體路徑, filter 為下列其中一或多項: /type:devicetype /soname:soname 及 /info 為顯示所有裝置屬性的參數。 範例: posdm adddevice COM3 /soname:MsrSimulator 硬體路徑為 COM3 的裝置便會新增至 MsrSimulator 服務物件。 |
addname |
將邏輯名稱新增至裝置。 |
posdm [一般參數] addnamedevicenamefilter 其中 devicename 為提供給裝置的邏輯名稱,filter 則是唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 範例: posdm addname MainMSR /type:MSR /path:COM3 COM3 硬體路徑的 MSR 裝置便會新增邏輯名稱 MainMSR。 posdm addname BackupMSR /name:MainMSR 名稱為 MainMSR 的裝置便會新增邏輯名稱 BackupMSR。 |
addproperty |
將組態屬性新增至裝置。 |
posdm [一般參數] addpropertypropertyname value filter[/info] 其中 propertyname 為屬性名稱,value 為該屬性的初始值,filter 則為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename /info 為顯示所有裝置屬性的參數。 範例: posdm addproperty PrintSpecialGreeting 「Happy New Year!」 /name:MainMSR 如此會將具有「Happy New Year!」值的 PrintSpecialGreeting 屬性新增至名稱為 MainMSR 的裝置。 |
deletedevice |
刪除非隨插即用的實體裝置。 |
posdm [一般參數] deletedevice[path] filter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path 範例: posdm deletedevice COM3 /type:Msr 如此會刪除 COM3 上的 MSR 裝置。 僅可刪除先前透過 adddevice 命令新增的裝置。 |
deletename |
從裝置的名稱清單中刪除邏輯名稱。 |
posdm [一般參數] deletename devicenamefilter [/info] 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 及 /info 為顯示所有裝置屬性的參數。 範例: posdm deletename "Main Scanner" /type:Scanner /path:COM3 COM3 路徑的掃描器裝置便會刪除邏輯名稱「Main Scanner」。 僅可刪除先前透過 addname 命令新增的邏輯名稱。 |
deleteproperty |
刪除裝置的組態屬性。 |
posdm [一般參數] deletepropertypropertyname filter [/info] 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 及 /info 為顯示所有裝置屬性的參數。 posdm deleteproperty PrintSpecialGreeting /name:MainMSR 名稱為 MainMSR 的裝置便會刪除 PrintSpecialGreeting 屬性。 僅可刪除先前透過 addproperty 命令新增的組態屬性。 |
disable |
防止實體 POS 裝置執行服務物件。 |
posdm [一般參數] disablefilter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 範例: posdm disable /name:ReceiptPrn 如此可防止名稱為 ReceiptPrn 的裝置執行服務物件。 因此,應用程式不會在可用的 POS 裝置清單中看到裝置。 |
enable |
允許實體 POS 裝置執行服務物件。 |
posdm [一般參數] enablefilter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 範例: posdm enable /type:MSR 如此可讓所有 MSR 裝置執行服務物件。 |
info |
顯示裝置的相關資訊,包含其組態屬性。 |
posdm [一般參數] 資訊filter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 範例: posdm info /name:MSR1 此命令會顯示邏輯名稱為「MSR1」的裝置相關資訊。 |
listdevices |
列出實體 POS 裝置。 |
posdm [一般參數] listdevices [/type:devicetype] 其中 /type:devicetype 參數將清單限縮為特定裝置類型。 範例: posdm listdevices 如此會顯示本機電腦上安裝的所有實體 POS 裝置清單。 posdm listdevices /type:MSR 如此會顯示本機電腦上安裝的所有 MSR 裝置清單。 posdm /machine:Center10 /username:JohnDoe3 /password:B$tg59ce listdevices 在以使用者名稱和密碼認證登入後,便會列出電腦名稱「Center10」安裝的所有實體 POS 裝置。 |
listnames |
列出與 POS 裝置相關聯的邏輯名稱。 |
posdm [一般參數] listnamesfilter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path 範例: posdm listnames /type:MSR /path:COM3 如此會顯示在 COM3 上與 MSR 裝置相關聯的名稱清單。 |
listprops |
列出與 POS 裝置及其值相關聯的組態屬性。 |
posdm [一般參數] listpropsfilter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 範例: posdm listprops /type:MSR /path:COM3 如此會顯示在 COM3 上與 MSR 裝置相關聯的屬性名稱和值清單。 |
listsos |
列出目標機器的 POS 服務物件。 |
posdm [一般參數] listsos [/type:devicetype] 其中 /type:devicetype 參數將清單限縮為特定裝置類型。 範例: posdm /output:a:\solist.txt listsos 本機電腦上安裝的所有服務物件清單便會寫入磁碟機 A 上名稱為「solist.txt」的檔案。 posdm listsos /type:MSR 如此會顯示本機電腦上與 MSR 裝置相關聯的所有服務物件清單。 posdm /machine:Center10 /username:JohnDoe3 /password:B$tg59ce listsos 在以使用者名稱和密碼認證登入後,便會列出電腦名稱「Center10」上的所有服務物件。 |
setdefault |
將某裝置設為其 type 的預設值。 預設旗標會指示 osExplorer.GetDevice(type) 方法傳回此裝置 (即使該類型有多個裝置)。 |
posdm [一般參數] setdefaultON|OFF filter[/info] 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename /info 參數會導致顯示所有裝置屬性。 範例: posdm setdefault ON /name:FirstScanner 此範例會指定 FirstScanner,作為 CCL 裝置列舉要尋找的值。 |
setpath |
設定非隨插即用裝置的 POS 裝置路徑。 |
posdm [一般參數] setpathhardware_path filter 其中 filter 為唯一識別裝置所需的下列一或多個部分: /type:devicetype /soname:soname /path:hardware_path /name:devicename 範例: posdm setpath COM2 /type:MSR MSR 裝置的硬體路徑便會設為 COM2。 setpath 命令僅適用於先前使用 adddevice 命令新增的非隨插即用裝置。 |