_Classe de ambiente Win32

A classe WMI do _ ambiente Win32 representa uma configuração de ambiente ou ambiente do sistema em um sistema de computador Windows. Consultar essa classe retorna variáveis de ambiente encontradas em:

HKEY _ _ Ambiente de \ \ \ controle \ \ CurrentControlSet do sistema de máquina local

e

HKEY _ \ Ambiente de < usuário > dos usuários \

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4D2-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("PutInstance"), SupportsDelete, DeleteBy("DeleteInstance"), SupportsUpdate, AMENDMENT]
class Win32_Environment : CIM_SystemResource
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  string   Name;
  boolean  SystemVariable;
  string   UserName;
  string   VariableValue;
};

Membros

A classe de _ ambiente Win32 tem estes tipos de membros:

Propriedades

A classe de _ ambiente Win32 tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: maxlen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto.

Essa propriedade é herdada do CIM _ ManagedSystemElement.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Descrição")

Uma descrição textual do objeto.

Essa propriedade é herdada do CIM _ ManagedSystemElement.

InstallDate

Tipo de dados: DateTime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. |Componente DMTF | 1,5 "), DisplayName (" data de instalação ")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada do CIM _ ManagedSystemElement.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Qualificadores: override ("Name"), Key, MappingStrings ("Win32Registry | sistema \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Cadeia de caracteres que especifica o nome de uma variável de ambiente baseada no Windows. Ao especificar o nome de uma variável que ainda não existe, um aplicativo cria uma nova variável de ambiente.

Exemplo: "caminho"

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: maxlen (10), DisplayName ("status")

Cadeia de caracteres que indica o status atual do objeto. O status operacional e não operacional pode ser definido. O status operacional pode incluir "OK", "degradado" e "Pred falha". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para inteligente).

O status não operacional pode incluir "erro", "Iniciando", "parando" e "serviço". O "serviço" pode ser aplicado durante o espelhamento de disco – reprateando, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros Estados.

Essa propriedade é herdada do CIM _ ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("erro")

Degradado ("degradado")

Desconhecido ("desconhecido")

Falha de Pred ("Pred Fail")

Iniciando ("Iniciando")

Parando ("parando")

Serviço ("serviço")

Sob estresse ("sob estresse")

Não recuperar ("Recover")

Sem contato ("sem contato")

Perda de comunicação ("perda de comunicação")

SystemVariable

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings (" | ambiente do Gerenciador de sessão de controle de CurrentControlSet do sistema Win32Registry \ \ \ \ \ \ \ \ ")

Indica se a variável é uma variável do sistema. Uma variável de sistema é definida pelo sistema operacional e é independente das configurações de ambiente do usuário.

UserName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: chave, maxlen (260), MappingStrings ("ambiente do Gerenciador de sessão de controle do Win32Registry do | sistema \ \ \ \ \ \ \ \ )

Nome do proprietário da configuração de ambiente. Ele é definido como para as configurações específicas do sistema baseado no Windows (em oposição a um usuário específico) e para as configurações de usuário padrão.

Exemplo: "JSmith"

VariableValue

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings (" | ambiente do Gerenciador de sessão de controle de CurrentControlSet do sistema Win32Registry \ \ \ \ \ \ \ \ ")

Variável de espaço reservado de uma variável de ambiente baseada no Windows. Informações como o diretório do sistema de arquivos podem mudar de computador para computador. O sistema operacional substitui espaços reservados para eles.

Exemplo: "% SystemRoot%"

Comentários

A classe de _ ambiente do Win32 é derivada do CIM _ SystemResource. Você pode usar essa classe para localizar os caminhos de pastas especiais, como a pasta do sistema ou os arquivos de programas em um computador remoto. Alguns exemplos são: WINDIR, SystemRoot, ProgramFiles e UserProfile. Win32 _ Basicamente, o ambiente retorna o que pode ser encontrado em:

HKEY _ _ Ambiente de \ \ \ controle \ \ CurrentControlSet do sistema de máquina local

e

HKEY _ \ Ambiente de < usuário > dos usuários \

O processo de chamada que usa essa classe deve ter o privilégio se _ Restore _ Name no computador em que o registro reside. Por exemplo, se você enumerar essa classe no computador local, a conta sob a qual seu aplicativo é executado deverá ter esse privilégio. Para obter mais informações, consulte executando operações privilegiadas.

Exemplos

A lista de variáveis de ambiente em um computador Perl exemplo usa WMI para retornar informações sobre todas as variáveis de ambiente em um computador.

O exemplo de código VBScript a seguir enumera as variáveis de ambiente no computador local.

strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set colVar = objWMIService.ExecQuery("Select * from Win32_Environment")
For Each objVar in colVar
    Wscript.Echo "Description: " & objVar.Description & VBNewLine _
               & "Name: " & objVar.Name & VBNewLine _
               & "System Variable: " & objVar.SystemVariable & VBNewLine _
               & "User Name: " & objVar.UserName & VBNewLine _
               & "Variable Value: " & objVar.VariableValue 
Next

O exemplo de código VBScript a seguir altera uma variável de ambiente chamada tipo de BUILD _ para uma entrada de valor pelo usuário. O script supõe que a variável de tipo de compilação _ já existe. Se ele não existir, o script será encerrado. O valor de entrada está marcado: deve ser "Build1", "Build2" ou "Build3", e nenhum outro valor é aceito. A função UCase do VBScript torna a entrada não diferencia maiúsculas de minúsculas. Se o que é digitado não for um dos três valores aceitáveis, o script será encerrado.

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_Environment")
Found = False
For Each objItem in colItems
    If objItem.Name = "BUILD_TYPE" Then
    Found = True
    Change = UCase(InputBox("BUILD_TYPE currently = " & objItem.VariableValue & VBNewLine _
                          & "Change options are Build1, Build2, Build3 "))
        If UCase(Change) = "BUILD1" OR Change = "BUILD2" OR Change = "BUILD3" Then
            objItem.VariableValue = Change
            objItem.Put_
        WScript.Echo "BUILD_TYPE changed to " & objItem.VariableValue
        Else 
        WScript.Echo "No input or unacceptable input." & " No change to BUILD_TYPE"
        End If
    End If
Next
If Found = False Then
    WScript.Echo "User-defined environment variable BUILD_TYPE not found."
End If

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Raiz \ cimv2
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Confira também

_SYSTEMRESOURCE CIM

Classes do sistema operacional