Класс Win32_TCPIPPrinterPort
Класс WMIWin32_TCPIPPrinterPort представляет точку доступа службы TCP/IP.
Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.
Синтаксис
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;
};
Члены
Класс Win32_TCPIPPrinterPort имеет следующие типы членов:
Элемент Property
Класс Win32_TCPIPPrinterPort имеет следующие свойства.
-
ByteCount
-
-
Тип данных: boolean
-
Тип доступа: только для чтения
Если задано значение TRUE, компьютер подсчитывает байты в документе перед их отправкой на принтер, и принтер сообщает о количестве фактически прочитанных байтов. Эта возможность используется для диагностика при обнаружении отсутствующих байтов в выходных данных печати.
-
-
Caption
-
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: MaxLen (64), DisplayName ("Caption")
Краткое текстовое описание объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
-
-
CreationClassName
-
Имя класса или подкласса, используемого при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры класса и его подклассы.
Это свойство наследуется от CIM_ServiceAccessPoint.
-
Описание
-
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Описание")
Текстовое описание объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
-
-
HostAddress
-
-
Тип данных: string
-
Тип доступа: только для чтения
Адрес устройства или сервера печати.
-
-
InstallDate
-
-
Тип данных: datetime
-
Тип доступа: только для чтения
-
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")
Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.
Это свойство наследуется от CIM_ManagedSystemElement.
-
-
имя;
-
Уникально идентифицирует точку доступа службы и указывает на управляемые функциональные возможности. Эта функция более подробно описана в свойстве Description объекта.
Это свойство наследуется от CIM_ServiceAccessPoint.
-
Номер порта
-
-
Тип данных: uint32
-
Тип доступа: только для чтения
Количество TCP-портов, используемых монитором портов для связи с устройством.
-
-
протокол;
-
-
Тип данных: uint32
-
Тип доступа: только для чтения
Используемый протокол печати. Некоторые принтеры поддерживают только LPR.
-
-
1
-
RAW
Печать непосредственно на устройстве или сервере печати.
-
2
-
LPR
Устаревший протокол, который в конечном итоге заменен на RAW.
Очередь
-
Тип данных: string
-
Тип доступа: только для чтения
Имя очереди печати на сервере при использовании с протоколом LPR.
SNMPCommunity
-
Тип данных: string
-
Тип доступа: только для чтения
Значение уровня безопасности для устройства.
Пример: "public""
SNMPDevIndex
-
Тип данных: uint32
-
Тип доступа: только для чтения
Номер индекса SNMP этого устройства для агента SNMP.
SNMPEnabled
-
Тип данных: boolean
-
Тип доступа: только для чтения
Если задано значение TRUE, этот принтер поддерживает RFC 1759 (протокол простого управления сетью) и может предоставлять подробные сведения о состоянии с устройства.
Состояние
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: MaxLen (10), DisplayName ("Status")
Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочее состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой pred". "Pred Fail" указывает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).
Состояние "Нерабочее" может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время повторного зеркало диска, перезагрузки списка разрешений пользователя или выполнения других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.
Это свойство наследуется от CIM_ManagedSystemElement.
В эти значения входят:
ОК ("ОК")
Error ("Error")
Пониженный ("Пониженный")
Unknown ("Unknown")
Pred Fail ("Pred Fail")
Запуск ("Запуск")
Остановка ("Остановка")
Служба ("Служба")
Подчеркнуто ("подчеркнуто")
NonRecover ("NonRecover")
Нет контакта ("Нет контакта")
Lost Comm ("Lost Comm")
SystemCreationClassName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key, MaxLen (256)
Имя класса создания системы области.
Это свойство наследуется от CIM_ServiceAccessPoint.
SystemName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key, MaxLen (256)
Имя системы определения области.
Это свойство наследуется от CIM_ServiceAccessPoint.
Тип
-
Тип данных: uint32
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32")
Тип SAP, например присоединенный или перенаправленный.
Это свойство наследуется от CIM_ServiceAccessPoint.
Запись (1)
Чтение (2)
Перенаправлено (4)
Net_Attached (8)
unknown (16)
Комментарии
Класс Win32_TCPIPPrinterPort является производным от CIM_ServiceAccessPoint который является производным от CIM_LogicalElement.
Для удаления экземпляра этого класса WMI требуется привилегия SeLoadDriverPrivilege . В следующем фрагменте скрипта показано, как установить подключение к WMI, использующее эту привилегию.
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate, (LoadDriver)}")
Примеры
Следующий пример PowerShell удаляет принтер и связанный с ним порт принтера TCPIP.
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()
}
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista |
Минимальная версия сервера |
Windows Server 2008 |
Пространство имен |
Root\CIMV2 |
MOF |
|
DLL |
|
См. также раздел