共用方式為

Win32_TCPIPPrinterPort 類別

  • 發行項

Win32_TCPIPPrinterPortWMI 類別代表 TCP/IP 服務存取點。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。 屬性會依字母順序列出，而非 MOF 順序。

語法

class Win32_TCPIPPrinterPort : CIM_ServiceAccessPoint
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  string   CreationClassName;
  string   Name;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   Type;
  boolean  ByteCount;
  string   HostAddress;
  uint32   PortNumber;
  uint32   Protocol;
  string   Queue;
  string   SNMPCommunity;
  uint32   SNMPDevIndex;
  boolean  SNMPEnabled;
};

成員

Win32_TCPIPPrinterPort類別具有下列類型的成員：

屬性

Win32_TCPIPPrinterPort類別具有這些屬性。

ByteCount

資料類型： 布林值

存取類型：唯讀

如果 為 TRUE，則電腦會在將位元組傳送至印表機之前計算檔中的位元組數，而印表機會回報實際讀取的位元組數目。 當列印輸出中偵測到遺漏的位元組時，這項功能會用於診斷。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

CreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： CIM_Key、 MaxLen (256)

建立實例時所使用的類別或子類別名稱。 與 類別的其他索引鍵屬性搭配使用時，這個屬性可讓類別及其子類別的所有實例唯一識別。

此屬性繼承自 CIM_ServiceAccessPoint。

說明

資料類型： 字串

存取類型：唯讀

限定詞： DisplayName (「Description」)

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

HostAddress

資料類型： 字串

存取類型：唯讀

裝置或列印伺服器的位址。

InstallDate

資料類型： datetime

存取類型：唯讀

限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

指出何時安裝 物件。 缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

名稱

資料類型： 字串

存取類型：唯讀

限定詞： Key、 MaxLen (256)

可唯一識別服務存取點，並提供所管理功能的指示。 在物件的 Description 屬性中會更詳細地描述這項功能。

此屬性繼承自 CIM_ServiceAccessPoint。

PortNumber

資料類型： uint32

存取類型：唯讀

埠監視器用來與裝置通訊的 TCP 埠數目。

通訊協定

資料類型： uint32

存取類型：唯讀

使用的列印通訊協定。 某些印表機僅支援 LPR。

1

RAW

直接列印到裝置或列印伺服器。

2

Lpr

舊版通訊協定，最終會由 RAW 取代。

佇列

資料類型： 字串

存取類型：唯讀

搭配 LPR 通訊協定使用時，伺服器上的列印佇列名稱。

SNMPCommunity

資料類型： 字串

存取類型：唯讀

裝置的安全性層級值。

範例：「public'」

SNMPDevIndex

資料類型： uint32

存取類型：唯讀

SNMP 代理程式的此裝置 SNMP 索引編號。

SNMPEnabled

資料類型： 布林值

存取類型：唯讀

如果 為 TRUE，此印表機支援 RFC 1759 (簡單網路管理通訊協定) ，而且可以從裝置提供豐富的狀態資訊。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10) 、 DisplayName (「Status」)

表示物件目前狀態的字串。 您可以定義作業和非操作狀態。 作業狀態可以包括 「OK」、「已降級」 和 「Pred Fail」。 「預先失敗」表示元素正常運作，但正在預測失敗 (例如，已啟用 SMART 的硬碟) 。

非操作狀態可以包含「錯誤」、「啟動」、「停止」和「服務」。 「服務」可以在磁片鏡像重新儲存期間套用、重載使用者許可權清單或其他系統管理工作。 並非所有這類工作都處於線上狀態，但 Managed 元素不是「確定」，也不是在其他其中一種狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 (「確定」)

錯誤 (「錯誤」)

降級 (「已降級」)

未知 (「未知」)

預先失敗 (「預先失敗」)

開始 (「開始」)

停止 (「停止」)

服務 (「服務」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

沒有連絡人 (「沒有連絡人」)

Lost Comm (「Lost Comm」)

SystemCreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 (「CIM_System。CreationClassName「) ， CIM_Key， MaxLen (256)

範圍系統的建立類別名稱。

此屬性繼承自 CIM_ServiceAccessPoint。

SystemName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 (「CIM_System。Name「) ， CIM_Key， MaxLen (256)

範圍系統的名稱。

此屬性繼承自 CIM_ServiceAccessPoint。

類型

資料類型： uint32

存取類型：唯讀

限定詞： 架構 (「Win32」)

SAP 的類型，例如附加或重新導向。

此屬性繼承自 CIM_ServiceAccessPoint。

寫入 (1)

閱讀 (2)

重新導向 (4)

Net_Attached (8)

未知 (16)

備註

Win32_TCPIPPrinterPort類別衍生自衍生自CIM_LogicalElementCIM_ServiceAccessPoint。

需要 SeLoadDriverPrivilege 許可權，才能刪除此 WMI 類別的實例。 下列腳本程式碼片段示範如何連線至使用此許可權的 WMI。

Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate, (LoadDriver)}")

範例

下列 PowerShell 範例會移除印表機和相關聯的 TCPIP 印表機埠。

function Remove-PrinterAndPort{
    Param( $printername )
   $printer=gwmi win32_Printer -filter "name='HPDJ600'"
   $printer.Delete()
   $port=gwmi win32_tcpipprinterport -filter "name='$($printer.portname)'" -enableall
   $port.Delete()
}

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
命名空間
 Root\CIMV2
MOF
Win32_Printer.mof
DLL
CIMWin32.dll

另請參閱

CIM_ServiceAccessPoint

電腦系統硬體類別