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

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

计算机系统硬件类