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