Win32_TSLogonSetting クラス

  • [アーティクル]

Win32_TSLogonSetting WMI クラスは、クライアント ログオンに関連するWin32_Terminal クラスの構成設定を定義します。

次の構文は MOF コードから簡略化され、定義および継承されたすべてのプロパティがアルファベット順に含まれています。 メソッドのリファレンス情報については、このトピックで後述するメソッドの表を参照してください。

構文

[dynamic, provider("Win32_WIN32_TSLOGONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSLogonSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ClientLogonInfoPolicy;
  string   Domain;
  string   Password;
  uint32   PolicySourceDomain;
  uint32   PolicySourcePromptForPassword;
  uint32   PolicySourceUserName;
  uint32   PromptForPassword;
  string   UserName;
};

メンバー

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

メソッド

Win32_TSLogonSetting クラスには、これらのメソッドがあります。

メソッド 説明
ExplicitLogon UserName、Password、および Domain の認証資格情報を設定します。
SetPromptForPassword PromptForPassword プロパティを設定します。

プロパティ

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

Caption

データ型: string

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

修飾子: MaxLen (64)

オブジェクトの短い説明 (1 行文字列)。

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

ClientLogonInfoPolicy

データ型: uint32

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

サーバーが接続設定を決定するために使用するポリシー。

ユーザーごと (0)

個々のユーザー接続設定が有効です。

サーバーオーバーライド (1)

個々のユーザー接続設定は、サーバーによってオーバーライドされます。

説明

データ型: string

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

オブジェクトの説明。

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

ドメイン

データ型: string

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

ユーザーのドメイン ログオン認証資格情報。 これは、ユーザーのコンピューターが存在するドメインです。 このプロパティは 17 文字以内にしてください。

InstallDate

データ型: datetime

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

修飾子: マッピング文字列 ("MIF.DMTF|ComponentID|001.5")

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

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

名前

データ型: string

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

オブジェクトの名前。

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

パスワード

データ型: string

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

ユーザーのパスワード ログオン認証資格情報。 このプロパティは 14 文字以内にしてください。 このプロパティを照会する場合は、セキュリティ レベルをパケット プライバシー (wbemAuthenticationLevelPktPrivacy = 6) に設定することをお勧めします。 これは、このレベルのセキュリティがないと、ネットワーク上でパスワードが暗号化されないためです。 セキュリティ レベルの設定の詳細については、WMI SDK ドキュメントの 「クライアント アプリケーション プロセス セキュリティの設定 」を参照してください。

PolicySourceDomain

データ型: uint32

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

Domain プロパティがサーバー、グループ ポリシー、または既定で構成されているかどうかを示します。

0

サーバー

1

グループ ポリシー

2

Default

PolicySourcePromptForPassword

データ型: uint32

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

PromptForPassword プロパティがサーバー、グループ ポリシー、または既定で構成されているかどうかを示します。

0

サーバー

1

グループ ポリシー

2

Default

PolicySourceUserName

データ型: uint32

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

UserName プロパティがサーバー、グループ ポリシー、または既定で構成されているかどうかを示します。

0

サーバー

1

グループ ポリシー

2

Default

PromptForPassword

データ型: uint32

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

サーバーへのログイン中にユーザーに常にパスワードの入力を求めるかどうかを指定します。

FALSE (0)

ユーザーはパスワードの入力を求められません。

TRUE (1)

ユーザーにパスワードの入力を求めるメッセージが表示されます。

状態

データ型: string

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

修飾子: MaxLen (10)

オブジェクトの現在の状態。 さまざまな操作状態と非操作状態を定義できます。 運用状態には、"OK"、"Degraded"、"Pred Fail" (SMART 対応ハード ディスク ドライブなどの要素が正常に機能している可能性がありますが、近い将来に障害が予測される可能性があります) が含まれます。 非操作状態には、"Error"、"Starting"、"Stopping"、および "Service" が含まれます。 後者の "サービス" は、ディスクのミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用される可能性があります。 このような作業がすべてオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

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

("OK")

("Error")

("Degraded")

("Unknown")

("Pred Fail")

("Starting")

("Stopping")

("Service")

TerminalName

データ型: string

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

ターミナルの名前。

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

UserName

データ型: string

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

ユーザーのユーザー名ログオン認証資格情報。 このプロパティは 20 文字以内にしてください。

注釈

コンソール セッションに関連付けられている Winstation は、このクラスのメソッドとプロパティにアクセスできないことに注意してください。 TerminalName プロパティの値として "Console" を指定して試行した場合、このオブジェクトのメソッドは WBEM_E_NOT_SUPPORTEDを返します。 このエラー コードは、ウィンドウ ステーションがこのオブジェクトのメソッドを呼び出して LocalSystem、LocalService、または NetworkService アカウントのセキュリティ プロパティを追加または変更しようとした場合に返されます。

\root\CIMV2\TerminalServices 名前空間に接続するには、認証レベルにパケット プライバシーを含める必要があります。 C/C++ 呼び出しの場合、これは RPC_C_AUTHN_LEVEL_PKT_PRIVACYの認証レベルです。 Visual Basic 呼び出しとスクリプト呼び出しの場合、これは WbemAuthenticationLevelPktPrivacy または "pktPrivacy" の認証レベルであり、値は 6 です。 次の Visual Basic Scripting Edition (VBScript) の例は、パケット プライバシーを使用してリモート コンピューターに接続する方法を示しています。

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Microsoft Windows ソフトウェア開発キット (SDK) の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

要件

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

こちらもご覧ください

Win32_Terminal

Win32_TerminalSetting