classe Win32_TCPIPPrinterPort
A classe WMIWin32_TCPIPPrinterPort representa um ponto de acesso de serviço TCP/IP.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.
Sintaxe
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;
};
Membros
A classe Win32_TCPIPPrinterPort tem estes tipos de membros:
Propriedades
A classe Win32_TCPIPPrinterPort tem essas propriedades.
-
ByteCount
-
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Se TRUE, o computador conta os bytes em um documento antes de enviá-los para a impressora e a impressora relata o número de bytes realmente lidos. Essa funcionalidade é usada para diagnóstico quando bytes ausentes são detectados na saída de impressão.
-
-
Legenda
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (64), DisplayName ("Caption")
Uma breve descrição textual do objeto.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
CreationClassName
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Nome da classe ou subclasse usada na criação de uma instância. Quando usada com outras propriedades de chave da classe , essa propriedade permite que todas as instâncias da classe e suas subclasses sejam identificadas exclusivamente.
Essa propriedade é herdada de CIM_ServiceAccessPoint.
-
-
Descrição
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Description")
Uma descrição textual do objeto.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
HostAddress
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Endereço do dispositivo ou servidor de impressão.
-
-
InstallDate
-
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")
Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
Nome
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Identifica exclusivamente o ponto de acesso do serviço e fornece uma indicação da funcionalidade gerenciada. Essa funcionalidade é descrita mais detalhadamente na propriedade Description do objeto.
Essa propriedade é herdada de CIM_ServiceAccessPoint.
-
-
Número_da_porta
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Número de portas TCP usadas pelo monitor de porta para se comunicar com o dispositivo.
-
-
Protocolo
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Protocolo de impressão usado. Algumas impressoras dão suporte apenas à LPR.
-
-
1
-
RAW
Imprimir diretamente em um dispositivo ou servidor de impressão.
-
2
-
LPR
Protocolo herdado, que eventualmente é substituído por RAW.
Fila
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Nome da fila de impressão no servidor quando usado com o protocolo LPR.
SNMPCommunity
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Valor de nível de segurança para o dispositivo.
Exemplo: "public'"
SNMPDevIndex
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Número de índice SNMP deste dispositivo para o agente SNMP.
SNMPEnabled
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Se TRUE, essa impressora dá suporte ao RFC 1759 (Simple Network Management Protocol) e pode fornecer informações avançadas de status do dispositivo.
Status
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (10), DisplayName ("Status")
Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. As status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).
As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.
Essa propriedade é herdada de CIM_ManagedSystemElement.
Os valores incluem o seguinte:
OK ("OK")
Erro ("Erro")
Degradado ("Degradado")
Desconhecido ("Desconhecido")
Falha de pred ("Falha de pred")
Iniciando ("Iniciando")
Parando ("Parando")
Serviço ("Serviço")
Estressado ("Estressado")
NonRecover ("NonRecover")
Sem contato ("Sem contato")
Comm Perdido ("Comm Perdido")
SystemCreationClassName
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: Propagado ("CIM_System. CreationClassName"), CIM_Key, MaxLen (256)
O nome da classe de criação do sistema de escopo.
Essa propriedade é herdada de CIM_ServiceAccessPoint.
Systemname
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: Propagado ("CIM_System. Nome"), CIM_Key, MaxLen (256)
O nome do sistema de escopo.
Essa propriedade é herdada de CIM_ServiceAccessPoint.
Tipo
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: Esquema ("Win32")
Tipo de SAP, como anexado ou redirecionado.
Essa propriedade é herdada de CIM_ServiceAccessPoint.
Gravação (1)
Leitura (2)
Redirecionado (4)
Net_Attached (8)
desconhecido (16)
Comentários
A classe Win32_TCPIPPrinterPort é derivada de CIM_ServiceAccessPoint que deriva de CIM_LogicalElement.
O privilégio SeLoadDriverPrivilege é necessário para excluir uma instância dessa classe WMI. O snippet de script a seguir demonstra como fazer uma conexão com o WMI que usa esse privilégio.
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate, (LoadDriver)}")
Exemplos
O exemplo do PowerShell a seguir remove uma impressora e a porta da impressora TCPIP associada.
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()
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Confira também