Compartilhar via

classe Win32_TSLogonSetting

  • Artigo

A classe WMI Win32_TSLogonSetting define as definições de configuração para a classe Win32_Terminal relacionada ao logon do cliente.

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, provider("Win32_WIN32_TSLOGONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSLogonSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ClientLogonInfoPolicy;
  string   Domain;
  string   Password;
  uint32   PolicySourceDomain;
  uint32   PolicySourcePromptForPassword;
  uint32   PolicySourceUserName;
  uint32   PromptForPassword;
  string   UserName;
};

Membros

A classe Win32_TSLogonSetting tem estes tipos de membros:

Métodos

A classe Win32_TSLogonSetting tem esses métodos.

Método Descrição
ExplicitLogon Define as credenciais de autenticação UserName, Password e Domain.
SetPromptForPassword Define a propriedade PromptForPassword .

Propriedades

A classe Win32_TSLogonSetting 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.

ClientLogonInfoPolicy

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

A política que o servidor usa para determinar as configurações de conexão.

Por usuário (0)

As configurações de conexão de usuário individuais estão em vigor.

Substituição de servidor (1)

As configurações de conexão de usuário individuais são substituídas pelo servidor.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Domínio

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

A credencial de autenticação de logon de domínio do usuário. Esse é o domínio no qual o computador do usuário reside. Essa propriedade não pode ter mais de 17 caracteres.

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.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Senha

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

A credencial de autenticação de logon de senha do usuário. Essa propriedade não pode ter mais de 14 caracteres. É recomendável que você defina o nível de segurança como privacidade de pacotes (wbemAuthenticationLevelPktPrivacy = 6) se você consultar essa propriedade. Isso ocorre porque a senha não é criptografada na transmissão sem esse nível de segurança. Para obter mais informações sobre como definir níveis de segurança, consulte Configurando a segurança do processo do aplicativo cliente na documentação do SDK do WMI.

PolicySourceDomain

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade Domain está configurada pelo servidor, pela política de grupo ou por padrão.

0

Servidor

1

Política de grupo

2

Padrão

PolicySourcePromptForPassword

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade PromptForPassword está configurada pelo servidor, pela política de grupo ou por padrão.

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceUserName

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade UserName está configurada pelo servidor, pela política de grupo ou por padrão.

0

Servidor

1

Política de grupo

2

Padrão

PromptForPassword

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o usuário sempre é solicitado a fornecer uma senha durante o logon no servidor.

FALSE (0)

O usuário não é solicitado a fornecer uma senha.

TRUE (1)

O usuário é solicitado para uma senha.

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, recarregar 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")

("Pred Fail")

("Iniciando")

("Parando")

("Serviço")

TerminalName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do terminal.

Essa propriedade é herdada de Win32_TerminalSetting.

UserName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

A credencial de autenticação de logon de nome de usuário do usuário. Essa propriedade não pode ter mais de 20 caracteres.

Comentários

Lembre-se de que os Winstations associados à sessão do 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 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 o Visual Basic e chamadas de script, esse é um nível de autenticação de WbemAuthenticationLevelPktPrivacy ou "pktPrivacy", com um valor de 6. O exemplo a seguir do Visual Basic Scripting Edition (VBScript) 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

Win32_Terminal

Win32_TerminalSetting