Freigeben über


Win32_TCPIPPrinterPort-Klasse

Die Win32_TCPIPPrinterPortWMI-Klasse stellt einen TCP/IP-Dienstzugriffspunkt dar.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

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

Member

Die Win32_TCPIPPrinterPort-Klasse verfügt über folgende Membertypen:

Eigenschaften

Die Win32_TCPIPPrinterPort-Klasse verfügt über diese Eigenschaften.

ByteCount

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Bei TRUE zählt der Computer die Bytes in einem Dokument, bevor er sie an den Drucker sendet, und der Drucker meldet die Anzahl der tatsächlich gelesenen Bytes zurück. Diese Funktion wird für Diagnose verwendet, wenn fehlende Bytes in der Druckausgabe erkannt werden.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key, MaxLen (256)

Name der Klasse oder Unterklasse, die bei der Erstellung einer instance verwendet wird. Bei Verwendung mit anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen der -Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

HostAddress

Datentyp: string

Zugriffstyp: Schreibgeschützt

Adresse des Geräts oder Druckservers.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MaxLen (256)

Identifiziert den Dienstzugriffspunkt eindeutig und gibt einen Hinweis auf die verwaltete Funktionalität. Diese Funktionalität wird in der Description-Eigenschaft des Objekts ausführlicher beschrieben.

Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt.

Portnumber

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die Nummer der TCP-Ports, die vom Portmonitor für die Kommunikation mit dem Gerät verwendet werden.

Protokoll

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Verwendetes Druckprotokoll. Einige Drucker unterstützen nur LPR.

1

RAW

Direktes Drucken auf einem Gerät oder Druckserver.

2

LPR

Legacyprotokoll, das schließlich durch RAW ersetzt wird.

Warteschlange

Datentyp: string

Zugriffstyp: Schreibgeschützt

Name der Druckwarteschlange auf dem Server, wenn sie mit dem LPR-Protokoll verwendet wird.

SNMPCommunity

Datentyp: string

Zugriffstyp: Schreibgeschützt

Wert der Sicherheitsstufe für das Gerät.

Beispiel: "public""

SNMPDevIndex

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

SNMP-Indexnummer dieses Geräts für den SNMP-Agent.

SNMPEnabled

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Wenn TRUE, unterstützt dieser Drucker RFC 1759 (Simple Network Management Protocol) und kann umfangreiche status Informationen vom Gerät bereitstellen.

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Zeichenfolge, die die aktuelle status des Objekts angibt. Operative und nicht operative status können definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).

Nicht betriebsbereite status können "Error", "Starting", "Stopping" und "Service" enthalten. "Dienst" kann während der Datenträger-Spiegel-Resilvering, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. CreationClassName"), CIM_Key, MaxLen (256)

Der Name der Erstellungsklasse des Bereichssystems.

Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. Name"), CIM_Key, MaxLen (256)

Der Name des Bereichssystems.

Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt.

Typ

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

SAP-Typ, z. B. angefügt oder umgeleitet.

Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt.

Schreiben (1)

Lesen (2)

Umgeleitet (4)

Net_Attached (8)

unbekannt (16)

Bemerkungen

Die Win32_TCPIPPrinterPort-Klasse wird von CIM_ServiceAccessPoint abgeleitet, die von CIM_LogicalElement abgeleitet wird.

Das SeLoadDriverPrivilege-Recht ist erforderlich, um eine instance dieser WMI-Klasse zu löschen. Der folgende Skriptausschnitt veranschaulicht, wie Sie eine Verbindung mit WMI herstellen, die diese Berechtigung verwendet.

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

Beispiele

Im folgenden PowerShell-Beispiel werden ein Drucker und der zugehörige TCPIP-Druckerport entfernt.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
WindowsServer 2008
Namespace
Root\CIMV2
MOF
Win32_Printer.mof
DLL
CIMWin32.dll

Siehe auch

CIM_ServiceAccessPoint

Hardwareklassen des Computersystems