Win32 _ 環境クラス

Win32 _ 環境 WMI クラスは、Windows コンピューターシステム上の環境またはシステム環境設定を表します。 このクラスに対してクエリを実行すると、次の環境変数が返されます。

HKEY _ローカル _ コンピューター \ システム \ CurrentControlSet \ Control \ Sessionmanager \ 環境

および

HKEY _ユーザー の \ < ユーザー > \ 環境

次の構文はマネージド オブジェクト フォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。 プロパティは、MOF の順序ではなくアルファベット順に一覧表示されます。

構文

[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;
};

メンバー

Win32 _ 環境 クラスには、次の種類のメンバーがあります。

プロパティ

Win32 _ 環境 クラスには、これらのプロパティがあります。

Caption

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短い説明テキスト。

このプロパティは CIM _ ManagedSystemElementから継承されます。

説明

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: DisplayName ("説明")

オブジェクトの説明テキスト。

このプロパティは CIM _ ManagedSystemElementから継承されます。

InstallDate

データ型: datetime

アクセスの種類: 読み取り専用

修飾子: Mappingstrings ("MIF"DMTF | ComponentID | 001.5 ")、 DisplayName (" インストール日 ")

オブジェクトがいつインストールされたかを示します。 値が不足している場合は、そのオブジェクトがインストールされていないことを示しています。

このプロパティは CIM _ ManagedSystemElementから継承されます。

名前

データ型: 文字列

アクセスの種類: 読み取り/書き込み

修飾子: Override ("Name")、 keymappingstrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Windows ベースの環境変数の名前を指定する文字列。 まだ存在しない変数の名前を指定すると、アプリケーションによって新しい環境変数が作成されます。

例: "Path"

状態

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。 動作状態と非動作状態を定義できます。 動作状態には、"OK"、"低下"、および "Pred Fail" を含めることができます。 "Pred Fail" は、要素が適切に機能していることを示しますが、エラー (たとえば、スマート対応のハードディスクドライブ) を予測しています。

操作不可能な状態には、"エラー"、"開始"、"停止"、および "サービス" を含めることができます。 "サービス" は、ディスクのミラー化を再実行するとき、ユーザーのアクセス許可リストを再読み込みするとき、またはその他の管理作業を行うときに適用できます。 このような作業のすべてがオンラインであるとは限りませんが、マネージ要素は "OK" でも他の状態でもありません。

このプロパティは CIM _ ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("error")

低下 ("低下")

不明 ("不明")

Pred fail ("Pred fail")

開始 ("開始中")

停止 ("停止")

サービス ("サービス")

負荷 ("ストレス")

非復旧 ("非復旧")

連絡先なし ("連絡先なし")

失わ れた通信 ("失われた通信")

SystemVariable

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: Mappingstrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

変数がシステム変数であるかどうかを示します。 システム変数はオペレーティングシステムによって設定され、ユーザー環境設定とは独立しています。

UserName

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: keyMaxLen (260)、 mappingstrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

環境設定の所有者の名前。 < > Windows ベースのシステム (特定のユーザーではなく) に固有の設定と、 < > 既定のユーザー設定の既定値は [システム] に設定されています。

例: "JSmith"

VariableValue

データ型: 文字列

アクセスの種類: 読み取り/書き込み

修飾子: Mappingstrings ("Win32Registry | System \ \ CurrentControlSet \ \ Control \ \ Session Manager \ \ Environment")

Windows ベースの環境変数のプレースホルダー変数。 ファイルシステムディレクトリなどの情報は、コンピューター間で変更される可能性があります。 これらのプレースホルダーは、オペレーティングシステムによって置き換えられます。

例: "% SystemRoot%"

解説

Win32 _ 環境 クラスは CIM _ systemresourceから派生します。 このクラスを使用すると、リモートコンピューター上のシステムフォルダーやプログラムファイルなどの特別なフォルダーのパスを見つけることができます。 例として、windir、systemroot、programfiles、userprofile などがあります。 Win32 _環境 では、基本的に次のような内容が返されます。

HKEY _ローカル _ コンピューター \ システム \ CurrentControlSet \ Control \ Sessionmanager \ 環境

および

HKEY _ユーザー の \ < ユーザー > \ 環境

このクラスを使用する呼び出しプロセスには、レジストリが配置されているコンピューターに対する Standard Edition の _ 復元 _ 名 の特権が必要です。 たとえば、ローカルコンピューターでこのクラスを列挙する場合は、アプリケーションを実行するアカウントにこの特権が必要です。 詳細については、「 特権操作の実行」を参照してください。

コンピューターの環境変数を一覧表示する Perl サンプルでは、WMI を使用して、コンピューター上のすべての環境変数に関する情報を返します。

次の VBScript コード例では、ローカルコンピューター上の環境変数を列挙します。

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

次の VBScript コード例では、BUILD TYPE という名前の環境変数 _ を、ユーザーによって入力された値に変更します。 このスクリプトは、ビルドの種類の変数が既に存在していることを前提としてい _ ます。 存在しない場合は、スクリプトが終了します。 入力値は、"Build1"、"Build2"、または "Build3" のいずれかであり、他の値は受け入れられません。 VBScript の UCase 関数は、大文字と小文字を区別しない入力を行います。 に入力された値が、許容される3つの値のいずれでもない場合、スクリプトは終了します。

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

必要条件

要件
サポートされている最小のクライアント
Windows Vista
サポートされている最小のサーバー
Windows Server 2008
名前空間
ルート \ CIMV2
MOF
CIMWin32
[DLL]
CIMWin32.dll

関連項目

CIM _ systemresource

オペレーティング システム クラス