Win32_TCPIPPrinterPort 类

项目
06/12/2023

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，则计算机在将文档中的字节发送到打印机之前对其进行计数，并且打印机将报告实际读取的字节数。当在打印输出中检测到缺少字节时，此功能用于诊断。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

CreationClassName

数据类型： string
访问类型：只读
限定符： CIM_Key、 MaxLen (256)

创建实例时使用的类或子类的名称。与类的其他键属性一起使用时，此属性允许唯一标识类及其子类的所有实例。

此属性继承自 CIM_ServiceAccessPoint。

描述

数据类型： string
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

HostAddress

数据类型： string
访问类型：只读

设备或打印服务器的地址。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象的安装时间。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

名称

数据类型： string
访问类型：只读
限定符：键、 MaxLen (256)

唯一标识服务访问点，并提供所管理的功能的指示。对象的 Description 属性中更详细地描述了此功能。

此属性继承自 CIM_ServiceAccessPoint。

PortNumber

数据类型： uint32
访问类型：只读

端口监视器用于与设备通信的 TCP 端口数。

协议

数据类型： uint32
访问类型：只读

使用的打印协议。某些打印机仅支持 LPR。

1

RAW

直接打印到设备或打印服务器。

2

Lpr

旧协议，最终由 RAW 取代。

队列

数据类型： string
访问类型：只读

与 LPR 协议一起使用时服务器上的打印队列的名称。

SNMPCommunity

数据类型： string
访问类型：只读

设备的安全级别值。

示例：“public'”

SNMPDevIndex

数据类型： uint32
访问类型：只读

SNMP 代理的此设备的 SNMP 索引号。

SNMPEnabled

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则此打印机支持 RFC 1759 (简单网络管理协议) ，并且可以从设备提供丰富的状态信息。

Status

数据类型： string
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“已降级”和“预失败”。 “Pred Fail”表示元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

已降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

正在启动 (“正在启动”)

正在停止 (“停止”)

服务 (“Service”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

SystemCreationClassName

数据类型： string
访问类型：只读
限定符：传播 (“CIM_System。CreationClassName“) ， CIM_Key， MaxLen (256)

范围系统的创建类名称。

此属性继承自 CIM_ServiceAccessPoint。

SystemName

数据类型： string
访问类型：只读
限定符：传播 (“CIM_System。Name“) ， CIM_Key， MaxLen (256)

范围系统的名称。

此属性继承自 CIM_ServiceAccessPoint。

类型

数据类型： uint32
访问类型：只读
限定符：架构 (“Win32”)

SAP 的类型，例如附加或重定向。

此属性继承自 CIM_ServiceAccessPoint。

写入 (1)

阅读 (2)

重定向 (4)

Net_Attached (8)

未知 (16)

备注

Win32_TCPIPPrinterPort 类派生自派生自 CIM_LogicalElement 的 CIM_ServiceAccessPoint。

删除此 WMI 类的实例需要 SeLoadDriverPrivilege 权限。以下脚本代码片段演示如何建立与使用此权限的 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
计算机系统硬件类

通过

Win32_TCPIPPrinterPort 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

其他资源