Compartir a través de

Win32_TCPIPPrinterPort clase

  • Artículo

La clase WMI de Win32_TCPIPPrinterPort representa un punto de acceso de servicio TCP/IP.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

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;
};

Miembros

La clase Win32_TCPIPPrinterPort tiene estos tipos de miembros:

Propiedades

La clase Win32_TCPIPPrinterPort tiene estas propiedades.

ByteCount

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es TRUE, el equipo cuenta los bytes de un documento antes de enviarlos a la impresora y la impresora notifica el número de bytes leídos realmente. Esta funcionalidad se usa para diagnósticos cuando se detectan bytes que faltan en la salida de impresión.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), DisplayName ("Caption")

Una breve descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: CIM_Key, MaxLen (256)

Nombre de la clase o subclase usada en la creación de una instancia. Cuando se usa con otras propiedades clave de la clase , esta propiedad permite identificar todas las instancias de la clase y sus subclases.

Esta propiedad se hereda de CIM_ServiceAccessPoint.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

HostAddress

Tipo de datos: cadena

Tipo de acceso: solo lectura

Dirección del dispositivo o del servidor de impresión.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Key, MaxLen (256)

Identifica de forma única el punto de acceso de servicio y proporciona una indicación de la funcionalidad administrada. Esta funcionalidad se describe con más detalle en la propiedad Description del objeto.

Esta propiedad se hereda de CIM_ServiceAccessPoint.

Númerodepuerto

Tipo de datos: uint32

Tipo de acceso: solo lectura

Número de puertos TCP usados por el monitor de puerto para comunicarse con el dispositivo.

Protocolo

Tipo de datos: uint32

Tipo de acceso: solo lectura

Protocolo de impresión usado. Algunas impresoras solo admiten LPR.

1

RAW

Imprimir directamente en un dispositivo o en un servidor de impresión.

2

LPR

Protocolo heredado, que finalmente se reemplaza por RAW.

Cola

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de la cola de impresión en el servidor cuando se usa con el protocolo LPR.

SNMPCommunity

Tipo de datos: cadena

Tipo de acceso: solo lectura

Valor de nivel de seguridad para el dispositivo.

Ejemplo: "public'"

SNMPDevIndex

Tipo de datos: uint32

Tipo de acceso: solo lectura

Número de índice SNMP de este dispositivo para el agente SNMP.

SNMPEnabled

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es TRUE, esta impresora admite RFC 1759 (Protocolo simple de administración de red) y puede proporcionar información de estado enriquecida del dispositivo.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10), DisplayName ("Status")

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Ok", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante la resilveración de reflejo del disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "Correcto" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key, MaxLen (256)

Nombre de la clase de creación del sistema de ámbito.

Esta propiedad se hereda de CIM_ServiceAccessPoint.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. Name"), CIM_Key, MaxLen (256)

Nombre del sistema de ámbito.

Esta propiedad se hereda de CIM_ServiceAccessPoint.

Tipo

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Tipo de SAP, como adjunto o redirigido.

Esta propiedad se hereda de CIM_ServiceAccessPoint.

Escritura (1)

Lectura (2)

Redirigido (4)

Net_Attached (8)

desconocido (16)

Comentarios

La clase Win32_TCPIPPrinterPort se deriva de CIM_ServiceAccessPoint que se deriva de CIM_LogicalElement.

El privilegio SeLoadDriverPrivilege es necesario para eliminar una instancia de esta clase WMI. En el fragmento de código de script siguiente se muestra cómo establecer una conexión con WMI que usa este privilegio.

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

Ejemplos

En el ejemplo de PowerShell siguiente se quita una impresora y el puerto de impresora TCPIP asociado.

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()
}

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Espacio de nombres
 Root\CIMV2
MOF
Win32_Printer.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_ServiceAccessPoint

Clases de hardware del sistema de equipos