classe Win32_TSClientSetting

A classe WMI Win32_TSClientSetting define definições de configuração para a classe Win32_Terminal relacionada à política de conexã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_TSCLIENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSClientSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ConnectionPolicy;
  uint32   ConnectClientDrivesAtLogon;
  uint32   ConnectPrinterAtLogon;
  uint32   DefaultToClientPrinter;
  uint32   PolicySourceDefaultToClientPrinter;
  uint32   WindowsPrinterMapping;
  uint32   PolicySourceWindowsPrinterMapping;
  uint32   LPTPortMapping;
  uint32   PolicySourceLPTPortMapping;
  uint32   COMPortMapping;
  uint32   PolicySourceCOMPortMapping;
  uint32   DriveMapping;
  uint32   PolicySourceDriveMapping;
  uint32   AudioMapping;
  uint32   PolicySourceAudioMapping;
  uint32   ClipboardMapping;
  uint32   PolicySourceClipboardMapping;
  uint32   ColorDepthPolicy;
  uint32   PolicySourceColorDepthPolicy;
  uint32   ColorDepth;
  uint32   PolicySourceColorDepth;
  uint32   MaxMonitors;
  uint32   MaxXResolution;
  uint32   MaxYResolution;
  uint32   PolicySourceMaxMonitors;
  uint32   PolicySourceMaxResolution;
  uint32   PNPRedirection;
  uint32   PolicySourcePNPRedirection;
  uint32   AudioCaptureRedir;
  uint32   PolicySourceAudioCaptureRedir;
  uint32   VideoPlaybackRedir;
  uint32   PolicySourceVideoPlaybackRedir;
  uint32   AllowDwm;
  uint32   PolicySourceAllowDwm;
  uint32   PolicyAdvancedRemoteAppGraphics;
  uint32   AdvancedRemoteAppGraphics;
  uint32   RemoteSessionProfile;
  uint32   PolicySourceRemoteSessionProfile;
  uint32   AVC444ModePreferred;
  uint32   PolicySourceAvc444ModePreferred;
  uint32   EncodeImageQuality;
  uint32   PolicySourceEncodeImageQuality;
  uint32   HardwareGraphicsAdapter;
  uint32   PolicySourceHardwareGraphicsAdapter;
  uint32   SelectTransport;
  uint32   PolicySourceSelectTransport;
  uint32   SelectNetworkDetect;
  uint32   PolicySourceSelectNetworkDetect;
};

Membros

A classe Win32_TSClientSetting tem estes tipos de membros:

Métodos

A classe Win32_TSClientSetting tem esses métodos.

Método Descrição
ConnectionSettings Define as propriedades ConnectClientDrivesAtLogon, ConnectPrinterAtLogon e DefaultToClientPrinter dessa classe.
SetAllowDwm Sem suporte.
Windows 7 e Windows Server 2008 R2: Define a propriedade AllowDwm .
SetClientProperty Define a propriedade LPTPortMapping, COMPortMapping, AudioMapping, ClipboardMapping, DriveMapping ou WindowsPrinterMapping .
SetColorDepth Define a propriedade ColorDepth .
SetColorDepthPolicy Define a propriedade ColorDepthPolicy .
SetMaxMonitors Define a propriedade MaxMonitors .
SetMaxXResolution Define a propriedade MaxXResolution .
SetMaxYResolution Define a propriedade MaxYResolution .

Propriedades

A classe Win32_TSClientSetting tem essas propriedades.

AdvancedRemoteAppGraphics

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica se os elementos gráficos RemoteFX avançados devem ser habilitados para RemoteApp.

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

FALSE (0)

Elementos gráficos avançados estão desabilitados.

TRUE (1)

Os gráficos avançados estão habilitados.

AllowDwm

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Essa propriedade não está disponível.

**Windows 7 e Windows Server 2008 R2: **

Especifica se a composição da área de trabalho remota deve ser habilitada ou desabilitada. Zero desabilitará a composição da área de trabalho remota e um valor diferente de zero a habilitará.

Use o método SetAllowDwm para modificar essa propriedade.

AudioCaptureRedir

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o redirecionamento de captura de áudio deve ser permitido.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

FALSE (0)

TRUE (1)

AudioMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o mapeamento de áudio está desabilitado ou habilitado.

FALSE (0)

O mapeamento de áudio está habilitado.

TRUE (1)

O mapeamento de áudio está desabilitado.

AVC444ModePreferred

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica se o modo AVC444 é preferencial.

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: essa propriedade não está disponível antes de Windows 10 ou Windows Server 2016.

FALSE (0)

TRUE (1)

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.

Área de TransferênciaMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o mapeamento da área de transferência está desabilitado ou habilitado.

FALSE (0)

O mapeamento da área de transferência está habilitado.

TRUE (1)

O mapeamento da área de transferência está desabilitado.

ColorDepth

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica a profundidade da cor. Para obter valores possíveis, consulte o método SetColorDepth .

8 bits (1)

15 bits (2)

16 bits (3)

24 bits (4)

32 bits (5)

ColorDepthPolicy

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se a configuração de cor máxima do usuário deve ser substituída.

FALSE (0)

Não substitua a política do usuário.

TRUE (1)

Substitua a política do usuário.

COMPortMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o mapeamento de porta COM está desabilitado ou habilitado.

FALSE (0)

O mapeamento de porta COM está habilitado.

TRUE (1)

O mapeamento de porta COM está desabilitado.

ConnectClientDrivesAtLogon

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se as unidades do cliente serão conectadas automaticamente durante o processo de logon.

FALSE (0)

As unidades não serão conectadas automaticamente.

TRUE (1)

As unidades serão conectadas automaticamente.

ConnectionPolicy

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

A política que o servidor usa para recuperar as configurações de conexão do usuário.

Por usuário (0)

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

Substituição de servidor (1)

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

ConnectPrinterAtLogon

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se todas as impressoras locais mapeadas do cliente serão conectadas automaticamente durante o processo de logon.

FALSE (0)

As impressoras locais não serão conectadas automaticamente.

TRUE (1)

As impressoras locais serão conectadas automaticamente.

DefaultToClientPrinter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se os trabalhos de impressão serão enviados automaticamente para a impressora local do cliente.

FALSE (0)

Os trabalhos de impressão não devem ser enviados automaticamente para a impressora local do cliente.

TRUE (1)

Os trabalhos de impressão devem ser enviados automaticamente para a impressora local do cliente.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DriveMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o mapeamento de unidade está desabilitado ou habilitado.

FALSE (0)

O mapeamento de unidade está habilitado.

TRUE (1)

O mapeamento de unidade está desabilitado.

EncodeImageQuality

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica a qualidade da imagem para a experiência RDP.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

lossless (1)

high (2)

médio (3)

HardwareGraphicsAdapter

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica se o servidor host da sessão rd usa o renderizador de elementos gráficos de hardware como o adaptador padrão.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

FALSE (0)

TRUE (1)

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.

LPTPortMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o mapeamento de porta LPT está desabilitado ou habilitado.

FALSE (0)

O mapeamento de porta LPT está habilitado.

TRUE (1)

O mapeamento de porta LPT está desabilitado.

MaxMonitors

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O número máximo de monitores com suporte do servidor. Use o método SetMaxMonitors para modificar essa propriedade.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

MaxXResolution

Tipo de dados: uint32

Tipo de acesso: Somente leitura

A resolução X máxima compatível com o servidor. Use o método SetMaxXResolution para modificar essa propriedade.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

MaxYResolution

Tipo de dados: uint32

Tipo de acesso: Somente leitura

A resolução Y máxima compatível com o servidor. Use o método SetMaxYResolution para modificar essa propriedade.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

PNPRedirection

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o redirecionamento de Plug and Play deve ser permitido.

FALSE (0)

Permitir redirecionamento Plug and Play.

TRUE (1)

Não permita o redirecionamento Plug and Play.

PolicyAdvancedRemoteAppGraphics

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade AdvancedRemoteAppGraphics está configurada pela política de servidor ou grupo.

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

PolicySourceAllowDwm

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Essa propriedade não está disponível.

**Windows 7 e Windows Server 2008 R2: **

Indica se a propriedade AllowDwm está configurada pela política de servidor ou grupo.

0 (0x0)

Servidor

1 (0x1)

Política de grupo

PolicySourceAudioCaptureRedir

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade AudioCaptureRedir está configurada pela política de servidor ou grupo.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

0 (0x0)

Servidor

1 (0x1)

Política de grupo

PolicySourceAudioMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceAvc444ModePreferred

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica como a propriedade AVC444ModePreferredis está configurada.

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: essa propriedade não está disponível antes de Windows 10 ou Windows Server 2016.

0

Servidor

1

Política de Grupo

PolicySourceClipboardMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceColorDepth

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceColorDepthPolicy

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceCOMPortMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceDefaultToClientPrinter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceDriveMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceEncodeImageQuality

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica como EncodeImageQualityi está configurado.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

Servidor

1

Política de Grupo

PolicySourceHardwareGraphicsAdapter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica como o HardwareGraphicsAdapter está configurado.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

Servidor

1

Política de Grupo

PolicySourceLPTPortMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourceMaxMonitors

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

PolicySourceMaxResolution

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se as propriedades MaxXResolution e MaxYResolution são configuradas pelo servidor, pela política de grupo ou pelo padrão.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

PolicySourcePNPRedirection

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade PNPRedirection é configurada pelo servidor ou pela política de grupo.

0 (0x0)

Servidor

1 (0x1)

Política de grupo

PolicySourceRemoteSessionProfile

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica como o RemoteSessionProfile está configurado.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

Servidor

1

Política de Grupo

PolicySourceSelectNetworkDetect

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica como a propriedade SelectNetworkDetect está configurada.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

Servidor

1

Política de Grupo

PolicySourceSelectTransport

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica como a propriedade SelectTransport está configurada.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

Servidor

1

Política de Grupo

PolicySourceVideoPlaybackRedir

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade VideoPlaybackRedir está configurada pela política de servidor ou grupo.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

0 (0x0)

Servidor

1 (0x1)

Política de grupo

PolicySourceWindowsPrinterMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0 (0x0)

Servidor

1 (0x1)

Política de grupo

2 (0x2)

Padrão

RemoteSessionProfile

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica o perfil para a experiência rdp.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

scale (1)

experiência (2)

largura de banda (3)

SelecioneNetworkDetect

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica se a detecção de rede é usada.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

usado no momento da conexão e em estado estável.

1

desabilitado no momento da conexão

2

desabilitado em estado estável

3

desabilitado no momento da conexão e em estado estável.

SelectTransport

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Especifica quais protocolos de transporte podem ser usados para acesso RDP ao servidor.

Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: Essa propriedade não está disponível antes de Windows 8 ou Windows Server 2012.

0

Use UDP e TCP.

1

Use apenas TCP.

2

Use UDP ou TCP.

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.

VideoPlaybackRedir

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o redirecionamento de reprodução de vídeo deve ser permitido.

Windows Server 2008 e Windows Vista: Essa propriedade não está disponível antes do Windows Server 2008 R2 e do Windows 7.

FALSE (0)

TRUE (1)

WindowsPrinterMapping

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se o mapeamento de impressora está desabilitado ou habilitado para a janela do cliente.

FALSE (0)

O mapeamento de impressora está habilitado.

TRUE (1)

O mapeamento da impressora está desabilitado.

Comentários

Lembre-se de que uma estação de janela associada à sessão de console não pode 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 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 chamadas de script e Visual Basic, esse é um nível de autenticação de WbemAuthenticationLevelPktPrivacy ou "pktPrivacy", com um valor de seis.

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

CIM_Setting