classe Win32_TSEnvironmentSetting

A classe WMI Win32_TSEnvironmentSetting define as definições de configuração para a classe Win32_Terminal incluindo a política inicial do programa.

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_TSENVIRONMENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSEnvironmentSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ClientWallPaper;
  string   InitialProgramPath;
  uint32   InitialProgramPolicy;
  uint32   PolicySourceClientWallPaper;
  uint32   PolicySourceInitialProgramPath;
  uint32   PolicySourceStartIn;
  string   Startin;
};

Membros

A classe Win32_TSEnvironmentSetting tem estes tipos de membros:

Métodos

A classe Win32_TSEnvironmentSetting tem esses métodos.

Método Descrição
InitialProgram Define as propriedades do programa de inicialização incluídas nessa classe.
SetClientWallPaper Define a propriedade ClientWallPaper .

Propriedades

A classe Win32_TSEnvironmentSetting 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.

ClientWallPaper

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica se a imagem de papel de parede é exibida no cliente. Não exibir a imagem de papel de parede pode salvar recursos do sistema diminuindo o tempo necessário para repintar a tela.

False (0)

A imagem de papel de parede não é exibida no cliente.

True (1)

A imagem de papel de parede é exibida no cliente.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

InitialProgramPath

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome e o caminho do programa que o usuário executará imediatamente após o logon no servidor host da sessão rd.

InitialProgramPolicy

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

A política que o servidor usa para determinar o caminho do programa de inicialização e o nome do arquivo e o nome da pasta em que ele está localizado.

Por usuário (0)

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

Substituição de servidor (1)

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

Modo de aplicativo único (2)

Somente um único aplicativo será executado nesta sessão. As informações do programa de inicialização são ignoradas.

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.

PolicySourceClientWallPaper

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceInitialProgramPath

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

PolicySourceStartIn

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

0

Servidor

1

Política de grupo

2

Padrão

Iniciar

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O caminho do diretório de trabalho do programa em que o usuário será executado imediatamente após fazer logon no servidor host da sessão rd.

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.

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 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 o Visual Basic e chamadas de script, esse é 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
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Confira também

Win32_TerminalSetting