classe Win32_TSSessionDirectory
Define as definições de configuração do Agente de Conexão de Área de Trabalho Remota (Agente de Conexão de Área de Trabalho Remota) para a classe Win32_TSSessionDirectorySetting .
Observação
No Windows Server 2008 R2, o nome do Agente de Sessão de Serviços de Terminal (Agente de Sessão do TS) foi alterado para Agente de Conexão de Área de Trabalho Remota. Essas propriedades se aplicam a todos os sistemas operacionais com suporte, a menos que indicado de outra forma.
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_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string SessionDirectoryLocation;
uint32 PolicySourceSessionDirectoryLocation;
uint32 SessionDirectoryActive;
uint32 PolicySourceSessionDirectoryActive;
uint32 SessionDirectoryExposeServerIP;
uint32 PolicySourceSessionDirectoryExposeServerIP;
string SessionDirectoryClusterName;
uint32 PolicySourceLoadBalancing;
uint32 GetLoadBalancingState;
uint32 GetServerWeight;
uint32 PolicySourceSessionDirectoryClusterName;
string SessionDirectoryIPAddress;
uint32 GetTSRedirectorMode;
uint32 PolicySourceTSRedirectorMode;
};
Membros
A classe Win32_TSSessionDirectory tem estes tipos de membros:
Métodos
A classe Win32_TSSessionDirectory tem esses métodos.
| Método | Descrição |
|---|---|
| CreateUserDiskTemplate | Cria um modelo de disco de usuário. |
| DisableUserVhd | Desabilita um VHD de perfil de usuário. |
| EnableUserVhd | Habilita um VHD de perfil de usuário em um servidor RDSH. |
| GetCurrentRedirectableAddresses | Obtém a lista atualmente configurada de endereços qualificados para DNS e o tipo de redirecionamento. |
| GetRedirectableAddresses | Obtém toda a lista de endereços qualificados para DNS. |
| PingSessionDirectory | Verifica se o servidor do Agente de Conexão de Área de Trabalho Remota está disponível. |
| SetCurrentRedirectableAddresses | Define a lista configurada de endereços qualificados para DNS e o tipo de redirecionamento. |
| SetLoadBalancingState | Define o valor para indicar se o servidor participará do balanceamento de carga do Agente de Conexão de Área de Trabalho Remota. |
| SetServerWeight | Define o valor de peso do servidor para o balanceamento de carga do Agente de Conexão de Área de Trabalho Remota. |
| SetSessionDirectoryActive | Desabilita e habilita o Agente de Conexão de Área de Trabalho Remota. |
| SetSessionDirectoryExposeServerIP | Define a propriedade SessionDirectoryExposeServerIP . |
| SetSessionDirectoryProperty | Define a propriedade SessionDirectoryLocation ou a propriedade SessionDirectoryClusterName . |
| SetTSRedirectorMode | Esse método não está disponível. |
Propriedades
A classe Win32_TSSessionDirectory 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.
-
-
GetLoadBalancingState
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se o servidor está configurado para participar do balanceamento de carga do Agente de Conexão de Área de Trabalho Remota.
-
-
0
-
O servidor não está configurado para participar do balanceamento de carga do Agente de Conexão de Área de Trabalho Remota.
-
1
-
O servidor está configurado para participar do balanceamento de carga do Agente de Conexão de Área de Trabalho Remota.
GetServerWeight
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Recupera o valor de peso do servidor usado no balanceamento de carga do Agente de Conexão de Área de Trabalho Remota.
GetTSRedirectorMode
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se o servidor está configurado para atuar como um redirecionador dos Serviços de Área de Trabalho Remota.
0
O servidor está configurado para atuar como um redirecionador dos Serviços de Área de Trabalho Remota.
1
O servidor não está configurado para atuar como um redirecionador de Serviços de Área de Trabalho Remota.
Windows Server 2008: Essa propriedade não está disponível.
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.
PolicySourceLoadBalancing
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se a propriedade GetLoadBalancingState está configurada pelo servidor ou pela política de grupo.
0 (0x0)
Servidor
1 (0x1)
Política de grupo
PolicySourceSessionDirectoryActive
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se a propriedade SessionDirectoryActive é configurada pelo servidor ou pela política de grupo.
0 (0x0)
Servidor
1 (0x1)
Política de grupo
PolicySourceSessionDirectoryClusterName
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se a propriedade SessionDirectoryClusterName está configurada pelo servidor ou pela política de grupo.
0 (0x0)
Servidor
1 (0x1)
Política de grupo
PolicySourceSessionDirectoryExposeServerIP
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se a propriedade SessionDirectoryExposeServerIP está configurada pelo servidor ou pela política de grupo.
0 (0x0)
Servidor
1 (0x1)
Política de grupo
PolicySourceSessionDirectoryLocation
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Indica se a propriedade SessionDirectoryLocation está configurada pelo servidor ou pela política de grupo.
0 (0x0)
Servidor
1 (0x1)
Política de grupo
PolicySourceTSRedirectorMode
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Essa propriedade não está disponível.
Windows Server 2008 R2: Indica se a propriedade GetTSRedirectorMode está configurada pelo servidor ou pela política de grupo.
0 (0x0)
Servidor
1 (0x1)
Política de grupo
SessionDirectoryActive
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: chave
Especifica se os Serviços de Área de Trabalho Remota participam do Agente de Conexão de Área de Trabalho Remota.
FALSE (0)
A participação dos Serviços de Área de Trabalho Remota no Agente de Conexão de Área de Trabalho Remota está desabilitada.
TRUE (1)
A participação dos Serviços de Área de Trabalho Remota no Agente de Conexão de Área de Trabalho Remota está habilitada.
SessionDirectoryClusterName
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O endereço IP virtual do cluster ao qual pertence o servidor Host da Sessão de Área de Trabalho Remota.
SessionDirectoryExposeServerIP
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Especifica se a recuperação do endereço IP do Agente de Conexão de Área de Trabalho Remota é permitida.
FALSE (0)
A recuperação foi negada.
TRUE (1)
A recuperação é permitida.
SessionDirectoryIPAddress
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: leitura/gravação
O endereço IP do adaptador lan usado pelo diretório de sessão.
SessionDirectoryLocation
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O nome DNS de rede ou o endereço IP do servidor em que o serviço do Agente de Conexão de Área de Trabalho Remota está em execução.
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")
Comentários
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 seis.
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")
No Windows Server 2008, o nome do recurso Diretório de Sessão dos Serviços de Terminal foi alterado para Agente de Sessão de Serviços de Terminal.
No Windows Server 2008 R2, o nome do recurso Agente de Sessão dos Serviços de Terminal foi alterado para Agente de Conexão de Área de Trabalho Remota.
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 |
Nenhum compatível |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|