_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
-
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
-
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 |
|
| DLL |
|