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 estes 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 nessa 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
A quantidade máxima de tempo, em milissegundos, alocado para uma sessão ativa. Um valor de 0 especifica uma quantidade infinita de tempo.
-
-
BrokenConnectionAction
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
A ação que o servidor executa na sessão quando uma conexão foi interrompida devido à perda de rede ou excedeu os limites de tempo.
-
-
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 de 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 de 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 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.
TimeLimitPolicy
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
A política que o servidor usa para determinar os 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 de 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 pacotes. Para chamadas C/C++, esse seria um nível de autenticação de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Para o 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 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 |
|
| DLL |
|