classe Win32_Terminal

  • Artigo

A classe WMI Win32_Terminal representa um terminal.

A sintaxe a seguir é simplificada do código MOF e inclui todas as propriedades definidas e herdadas, em ordem alfabética. Para obter informações de referência sobre métodos, consulte a tabela de métodos mais adiante neste tópico.

Sintaxe

[dynamic, overwrite, provider("Win32_WIN32_TERMINAL_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_Terminal : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint32   fEnableTerminal;
  uint32   LoggedOnUsers;
  string   TerminalName;
};

Membros

A classe Win32_Terminal tem estes tipos de membros:

Métodos

A classe Win32_Terminal tem esses métodos.

Método Descrição
Criar Cria um terminal com configurações padrão que podem ser personalizadas usando as propriedades e os métodos das classes Win32_TerminalSetting .
Excluir Exclui o terminal especificado.
Habilitar Desabilita ou habilita o terminal.
Renomear Renomeia o terminal.

Propriedades

A classe Win32_Terminal tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64)

Descrição curta (cadeia de caracteres de uma linha) do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

fEnableTerminal

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o terminal especificado está desabilitado ou habilitado.

FALSE (0)

O terminal está desabilitado.

TRUE (1)

O terminal está habilitado.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: Mappingstrings ("MIF. DMTF| ComponentID|001.5")

A data em que 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.

LoggedOnUsers

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Número de sessões conectadas para o terminal.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10)

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevendo uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho resilvering de um disco, recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está on-line, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

("OK")

("Erro")

("Degradado")

("Desconhecido")

("Falha de Pred")

("Iniciando")

("Parando")

("Serviço")

TerminalName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: chave

O nome exclusivo que identifica a instância do terminal.

Comentários

Win32_Terminal está associado a Win32_TerminalSetting como a propriedade Element da associação Win32_TerminalTerminalSetting .

As seguintes classes são subclasses da classe Win32_Terminal : Win32_TSGeneralSetting, Win32_TSLogonSetting, Win32_TSSessionSetting, Win32_TSEnvironmentSetting, Win32_TSRemoteControlSetting, Win32_TSClientSetting, Win32_TSNetworkAdapterSetting, Win32_TSNetworkAdapterListSetting, Win32_TSPermissionsSetting e Win32_TSAccount.

Observe que winstations associados à sessão de console não podem acessar os métodos e as propriedades dessa classe. Se for feita uma tentativa de fazer isso especificando "Console" como o valor da propriedade TerminalName , os métodos desse objeto retornarão WBEM_E_NOT_SUPPORTED. Esse código de erro também será retornado se uma estação de janela tentar chamar métodos desse objeto para adicionar ou modificar as propriedades de segurança das contas LocalSystem, LocalService ou NetworkService.

Para se conectar ao namespace \root\CIMV2\TerminalServices, o nível de autenticação deve incluir privacidade de pacotes. Para chamadas C/C++, esse é um nível de autenticação de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Para chamadas de script e Visual Basic, esse é um nível de autenticação de WbemAuthenticationLevelPktPrivacy ou "pktPrivacy", com um valor de 6. O exemplo do Visual Basic Scripting Edition (VBScript) a seguir mostra como se conectar a um computador remoto com privacidade de pacotes.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

Os arquivos MOF (Managed Object Format) contêm as definições para classes WMI (Instrumentação de Gerenciamento do Windows). Os arquivos MOF não são instalados como parte do SDK (Software Development Kit) do Microsoft Windows. Eles são instalados no servidor quando você adiciona a função associada usando o Gerenciador do Servidor. Para obter mais informações sobre arquivos MOF, consulte MOF (Managed Object Format).

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMv2\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Confira também

CIM_LogicalElement

Win32_TerminalServiceSetting

Win32_TerminalTerminalSetting