共用方式為


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 命令新增的非隨插即用裝置。

另請參閱

概念

其他資源