_Classe TCPIPPrinterPort Win32

La classe WMI _ TCPIPPrinterPort WMI représente un point d’accès au service TCP/IP.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées par ordre alphabétique, et non par ordre MOF.

Syntaxe

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

Membres

La classe Win32 _ TCPIPPrinterPort possède les types de membres suivants :

Propriétés

La classe Win32 _ TCPIPPrinterPort a ces propriétés.

ByteCount

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est true, l’ordinateur compte les octets dans un document avant de les envoyer à l’imprimante et l’imprimante renvoie le nombre d’octets réellement lus. Cette fonctionnalité est utilisée pour les diagnostics quand des octets manquants sont détectés dans le résultat de l’impression.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM _ ManagedSystemElement.

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : _ clé CIM, MaxLen (256)

Nom de la classe ou de la sous-classe utilisée dans la création d’une instance. Lorsqu’elle est utilisée avec d’autres propriétés de clé de la classe, cette propriété autorise l’identification unique de toutes les instances de la classe et de ses sous-classes.

Cette propriété est héritée de CIM _ ServiceAccessPoint.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName ("Description")

Description textuelle de l’objet.

Cette propriété est héritée de CIM _ ManagedSystemElement.

HostAddress

Type de données : chaîne

Type d'accès : Lecture seule

Adresse du périphérique ou du serveur d’impression.

InstallDate

Type de données : DateTime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. DMTF | ComponentID | 001,5 "), DisplayName (" date d’installation ")

Indique le moment où l’objet a été installé. L’absence de valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM _ ManagedSystemElement.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé, MaxLen (256)

Identifie de façon unique le point d’accès au service et fournit une indication de la fonctionnalité gérée. Cette fonctionnalité est décrite plus en détail dans la propriété Description de l’objet.

Cette propriété est héritée de CIM _ ServiceAccessPoint.

Numéroport

Type de données : UInt32

Type d'accès : Lecture seule

Nombre de ports TCP utilisés par le moniteur de port pour communiquer avec l’appareil.

Protocole

Type de données : UInt32

Type d'accès : Lecture seule

Protocole d’impression utilisé. Certaines imprimantes prennent uniquement en charge LPR.

1

RAW

Impression directe sur un appareil ou un serveur d’impression.

2

LPR

Protocole hérité, qui est finalement remplacé par RAW.

File d’attente

Type de données : chaîne

Type d'accès : Lecture seule

Nom de la file d’attente à l’impression sur le serveur lorsqu’il est utilisé avec le protocole LPR.

SNMPCommunity

Type de données : chaîne

Type d'accès : Lecture seule

Valeur de niveau de sécurité pour l’appareil.

Exemple : « public »

SNMPDevIndex

Type de données : UInt32

Type d'accès : Lecture seule

Numéro d’index SNMP de cet appareil pour l’agent SNMP.

SNMPEnabled

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est true, cette imprimante prend en charge RFC 1759 (simple Network Management Protocol) et peut fournir des informations d’État enrichies à partir de l’appareil.

État

Type de données : chaîne

Type d'accès : Lecture seule

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

Chaîne qui indique l’état actuel de l’objet. L’état opérationnel et non opérationnel peut être défini. L’état opérationnel peut inclure « OK », « détérioré » et « échec prédit ». « Échec prédit » indique qu’un élément fonctionne correctement, mais prédit un échec (par exemple, un lecteur de disque dur intelligent).

L’état non opérationnel peut inclure « erreur », « démarrage », « arrêt » et « service ». Le « service » peut s’appliquer pendant la mise en miroir de disques, en rechargeant une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni l’un des autres États.

Cette propriété est héritée de CIM _ ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« erreur »)

Détérioré (« détérioré »)

Inconnu ("inconnu")

Échec prévu (« échec prédit »)

Démarrage en cours (« démarrage »)

Arrêt en cours (« arrêt »)

Service (« service »)

Stressed (« stressed »)

Non récupéré (« non récupéré »)

Aucun contact (« aucun contact »)

Communication perdue (« inversée comm »)

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Propaged ("CIM _ System.CreationClassName"), _ clé CIM, MaxLen (256)

Nom de la classe de création du système d’étendue.

Cette propriété est héritée de CIM _ ServiceAccessPoint.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Propaged ("CIM _ System.Name"), _ clé CIM, MaxLen (256)

Nom du système d’étendue.

Cette propriété est héritée de CIM _ ServiceAccessPoint.

Type

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32")

Type de SAP, tel que attaché ou redirigé.

Cette propriété est héritée de CIM _ ServiceAccessPoint.

Écriture (1)

Lecture (2)

Redirigé (4)

Réseau _ Attaché (8)

inconnu (16)

Notes

La classe Win32 _ TCPIPPrinterPort est dérivée de CIM _ ServiceAccessPoint qui dérive de CIM _ LogicalElement.

Le privilège SeLoadDriverPrivilege est requis pour supprimer une instance de cette classe WMI. L’extrait de script suivant montre comment établir une connexion à WMI qui utilise ce privilège.

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

Exemples

L’exemple PowerShell suivant supprime une imprimante et le port d’imprimante TCP/IP associé.

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
Win32 _ Printer. mof
DLL
CIMWin32.dll

Voir aussi

_SERVICEACCESSPOINT CIM

Classes matérielles du système informatique