Win32_LogonSession クラス

[アーティクル]
06/12/2023

Win32_LogonSession WMI クラス (「WMI クラスの取得」を参照) では、Windows を実行しているコンピューターシステムにログオンしているユーザーに関連付けられているログオンセッションまたはセッションについて説明します。

次の構文は、マネージドオブジェクト形式 (MOF) コードから簡略化され、継承されたすべてのプロパティが含まれています。プロパティとメソッドは、MOF の順序ではなく、アルファベット順です。

構文

[Dynamic, Provider("CIMWin32"), UUID("{9083C21E-7D58-4e0e-BC30-0BC8922AFB8B}"), AMENDMENT]
class Win32_LogonSession : Win32_Session
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime StartTime;
  string   AuthenticationPackage;
  string   LogonId;
  uint32   LogonType;
};

メンバー

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

Properties

プロパティ

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

AuthenticationPackage

データ型: string
アクセスの種類: 読み取り専用

ログオンセッションの認証に使用されるサブシステムの名前。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

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

このプロパティは 、CIM_ManagedSystemElementから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

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

このプロパティは 、CIM_ManagedSystemElementから継承されます。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされたタイミングを示します。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

LogonId

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

ログオンセッションに割り当てられた ID。

LogonType

データ型: uint32
アクセスの種類: 読み取り専用

ログオンセッションの種類を示す数値。

0

システムアカウントでのみ使用されます。

対話型 (2)

ターミナルサーバー、リモートシェル、または同様のプロセスによってログオンされているユーザーなど、コンピューターを対話形式で使用するユーザーを対象としています。

ネットワーク (3)

ハイパフォーマンスサーバーがクリアテキストパスワードを認証することを目的としています。 LogonUser は、このログオンの種類の資格情報をキャッシュしません。

Batch (4)

直接の介入なしにユーザーに代わってプロセスを実行できるバッチサーバーを対象としています。または、メールや Web サーバーなど、一度に多くのクリアテキスト認証試行を処理するパフォーマンスの高いサーバーの場合。 LogonUser は、このログオンの種類の資格情報をキャッシュしません。

サービス (5)

サービスの種類のログオンを示します。指定されたアカウントでは、サービス特権が有効になっている必要があります。

プロキシ (6)

プロキシの種類のログオンを示します。

ロック解除 (7)

このログオンの種類は、コンピューターを対話的に使用しているユーザーにログを記録する GINA DLL を対象としています。このログオンの種類により、ワークステーションのロックが解除された日時を示す一意の監査レコードを生成できます。

NetworkCleartext (8)

認証パッケージ内の名前とパスワードを保持し、サーバーがクライアントの偽装中に他のネットワークサーバーに接続できるようにします。これにより、サーバーはクライアントからのクリアテキスト資格情報を受け入れ、LogonUser を呼び出し、ユーザーがネットワーク経由でシステムにアクセスできることを確認し、引き続き他のサーバーと通信できます。

NewCredentials (9)

呼び出し元が現在のトークンを複製し、送信接続の新しい資格情報を指定できるようにします。新しいログオンセッションのローカル識別は同じですが、他のネットワーク接続には異なる資格情報が使用されます。

RemoteInteractive (10)

リモートと対話型の両方のターミナルサービスセッション。

CachedInteractive (11)

ネットワークにアクセスせずに、キャッシュされた資格情報を試行します。

CachedRemoteInteractive (12)

RemoteInteractive と同じです。これは、内部監査に使用されます。

CachedUnlock (13)

ワークステーションログオン。

Name

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Name")

オブジェクトが認識されるラベル。サブクラス化すると、このプロパティをキープロパティとしてオーバーライドできます。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

StartTime

データ型: datetime
アクセスの種類: 読み取り専用

セッションが開始された時刻。

このプロパティは、 Win32_Sessionから継承されます。

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。操作状態と非運用状態を定義できます。運用状態には、"OK"、"機能低下"、"Pred Fail" を含めることができます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハードディスクドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、および "サービス" が含まれる場合があります。 "サービス" は、ディスクミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

例

List Logon Session Information PowerShell サンプルは、コンピューターに現在ログオンしているユーザーに関連付けられているログオンセッションに関する情報を返します。

次の PowerShell の例では、指定したユーザーのリモートセッションが開かれているか確認します。

$user = "<user name>"
$servers = gci servers.txt 

     foreach ($server in $servers){
     $logons = gwmi win32_loggedonuser -computername $server

          foreach ($logon in $logons){
               if ($logon.antecedent -match $user){
               $logonid = $logon.dependent.split("=")[1] 
               $session =gwmi win32_logonsession |? {$_.logonid -match $logonid}
               if ($session.logontype -eq "10"){
               Write-host "You have an active Terminal Server session on server $($server)"
                }
          }

要件

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

こちらもご覧ください

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

次の方法で共有

Win32_LogonSession クラス

構文

メンバー

プロパティ

例

要件

こちらもご覧ください

フィードバック

その他のリソース