classe Win32_TSSessionSetting

A classe WMI Win32_TSSessionSetting define as configurações para a classe Win32_Terminal , como limites de tempo, e ações de desconexão e reconexão.

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_TSSESSIONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSSessionSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ActiveSessionLimit;
  uint32   BrokenConnectionAction;
  uint32   BrokenConnectionPolicy;
  uint32   DisconnectedSessionLimit;
  uint32   IdleSessionLimit;
  uint32   PolicySourceActiveSessionLimit;
  uint32   PolicySourceBrokenConnectionAction;
  uint32   PolicySourceDisconnectedSessionLimit;
  uint32   PolicySourceIdleSessionLimit;
  uint32   PolicySourceReconnectionPolicy;
  uint32   ReconnectionPolicy;
  uint32   TimeLimitPolicy;
  uint32   EnableTimeoutWarning;
};

Membros

A classe Win32_TSSessionSetting tem esses tipos de membros:

Métodos

A classe Win32_TSSessionSetting tem esses métodos.

Método Descrição
BrokenConnection Define as propriedades de conexão interrompidas incluídas nesta classe.
Timelimit Define as propriedades de limite de tempo incluídas nessa classe.

Propriedades

A classe Win32_TSSessionSetting tem essas propriedades.

ActiveSessionLimit

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O tempo máximo, em milissegundos, alocado para uma sessão ativa. Um valor 0 especifica uma quantidade infinita de tempo.

BrokenConnectionAction

Tipo de dados: uint32

Tipo de acesso: Somente leitura

A ação que o servidor realiza na sessão quando uma conexão foi interrompida devido à perda de rede ou a limites de tempo excedidos.

Desconectar (0)

O usuário está desconectado da sessão.

Encerrar (1)

A sessão é excluída permanentemente do servidor.

BrokenConnectionPolicy

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

A política que o servidor usa para determinar quando interromper uma conexão devido à perda de rede ou aos limites de tempo excedidos.

Substituição de servidor (1)

As configurações de política de desconexão do usuário são substituídas pelo servidor.

Por usuário (0)

As configurações de política de desconexão do usuário estão em vigor.

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.

DisconnectedSessionLimit

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O intervalo de tempo, em milissegundos, após o qual uma sessão desconectada é encerrada. Um valor 0 especifica uma quantidade infinita de tempo.

EnableTimeoutWarning

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Habilita o aviso de tempo limite.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: essa propriedade não está disponível.

IdleSessionLimit

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O intervalo de tempo, em milissegundos, após o qual uma sessão ociosa é encerrada. Um valor 0 especifica uma quantidade infinita de tempo.

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.

PolicySourceActiveSessionLimit

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceBrokenConnectionAction

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceDisconnectedSessionLimit

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceIdleSessionLimit

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceReconnectionPolicy

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

ReconnectionPolicy

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica se um usuário deve usar o cliente anterior para se reconectar a uma sessão desconectada.

Qualquer cliente (0)

Qualquer cliente será usado para se reconectar.

Cliente Anterior (1)

O cliente anterior usado em uma conexão será usado para se reconectar.

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 um disco rígido habilitado 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 o espelhamento de um disco, o recarregamento de uma lista de permissões do 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

O nome do terminal.

Essa propriedade é herdada de Win32_TerminalSetting.

TimeLimitPolicy

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

A política que o servidor usa para determinar limites de tempo para sessões de usuário.

Por usuário (0)

As configurações de política de limites de tempo do usuário estão em vigor.

Substituição do servidor (1)

As configurações de política de limites de tempo do usuário são substituídas pelo servidor.

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 também será retornado se uma estação de janela tentar chamar métodos desse objeto com a finalidade de 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 pacote. Para chamadas C/C++, esse seria um nível de autenticação de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Para Visual Basic e chamadas de script, esse seria um nível de autenticação de WbemAuthenticationLevelPktPrivacy ou "pktPrivacy", com um valor de 6. O exemplo de VBScript (Scripting Edition) Visual Basic 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 de Windows). Os arquivos MOF não são instalados como parte do Microsoft Windows Software Development Kit (SDK). 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 o 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_TerminalSetting

CIM_Setting