Win32_TCPIPPrinterPort classe

Article
06/12/2023

La classe WMI Win32_TCPIPPrinterPort représente un point d’accès de 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 dans l’ordre alphabétique, et non dans l’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 comporte les types de membres suivants :

Propriétés

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 d’un document avant de les envoyer à l’imprimante et l’imprimante signale le nombre d’octets réellement lus. Cette fonctionnalité est utilisée pour diagnostics lorsque des octets manquants sont détectés dans la sortie d’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 : CIM_Key, MaxLen (256)

Nom de la classe ou de la sous-classe utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec d’autres propriétés de clé de la classe, cette propriété permet à toutes les instances de la classe et à ses sous-classes d’être identifiées de manière unique.

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 de l’appareil 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 quand l’objet a été installé. L’absence d’une 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 : Key, MaxLen (256)

Identifie de manière unique le point d’accès de 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.

PortNumber

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 d’impression sur le serveur en cas d’utilisation 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 de status 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 la status actuelle de l’objet. Les status opérationnelles et non opérationnelles peuvent être définies. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un lecteur de disque dur compatible SMART).

Les status non opérationnelles peuvent inclure « Erreur », « Démarrage », « Arrêt » et « Service ». Le « service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans 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 de la préversion (« Échec prédé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

SystemCreationClassName

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : propagé (« CIM_System. CreationClassName »), CIM_Key, 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 : propagé (« CIM_System. Name »), CIM_Key, 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 : Schéma (« Win32 »)

Type de SAP, par exemple attaché ou redirigé.

Cette propriété est héritée de CIM_ServiceAccessPoint.

Écriture (1)

Lecture (2)

Redirigé ( 4)

Net_Attached (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 un instance de cette classe WMI. L’extrait de code 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 TCPIP 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	Racine\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Voir aussi

CIM_ServiceAccessPoint
Classes matérielles du système informatique

Partager via

Win32_TCPIPPrinterPort classe

Syntaxe

Membres

Propriétés

Notes

Exemples

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires