Compartilhar via

classe Win32_TSRemoteDesktop

  • Artigo

Descreve uma conexão de área de trabalho remota que está disponível por meio do Acesso à Web da Área de Trabalho Remota (Acesso à Web de Área de Trabalho Remota).

Sintaxe

class Win32_TSRemoteDesktop : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   Alias;
  string   SecurityDescriptor;
  string   IconPath;
  sint32   IconIndex;
  uint8    IconContents[];
  boolean  ShowInPortal;
  string   RDPFileContents;
  boolean  IsVmFarm;
  string   VmFarmSettings;
};

Membros

A classe Win32_TSRemoteDesktop tem estes tipos de membros:

Propriedades

A classe Win32_TSRemoteDesktop tem essas propriedades.

Alias

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Qualificadores: Chave

O alias da conexão de área de trabalho remota.

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.

IconContents

Tipo de dados: matriz uint8

Tipo de acesso: Somente leitura

O conteúdo do byte do ícone que corresponde à conexão de área de trabalho remota.

IconIndex

Tipo de dados: sint32

Tipo de acesso: leitura/gravação

O índice ou a ID do ícone para a conexão de área de trabalho remota.

IconPath

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Caminho do ícone para a conexão de área de trabalho remota.

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.

IsVmFarm

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Indica se essa conexão de área de trabalho remota faz parte de um farm de máquinas virtuais.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

RDPFileContents

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Conteúdo do arquivo RDP que corresponde à conexão de área de trabalho remota.

SecurityDescriptor

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Um descritor de segurança que controla o acesso à conexão de área de trabalho remota, no formato SDDL. Uma cadeia de caracteres vazia implica permitir todo o acesso. Esse descritor de segurança não dá suporte a ACEs DENY ou ACEs que se referem a usuários ou grupos nondomain.

ShowInPortal

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Indica se a conexão de área de trabalho remota deve ser mostrada no Acesso à Web de Área de Trabalho Remota.

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

VmFarmSettings

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Configurações do farm de máquinas virtuais para a conexão de área de trabalho remota.

Comentários

Você deve ser um membro do grupo Administradores para definir propriedades usando essa classe.

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, que pode ser definido usando a função COSetProxyBlanket COM. 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
 Nenhum compatível
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMv2\TerminalServices
MOF
Tsallow.mof
DLL
TsPubWmi.dll