IADsTSUserEx

リモートデスクトップサービスのユーザープロパティを確認および構成するために使用します。

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーにログオンするときに使用される、移動プロファイルまたは必須プロファイルのパスです。 (Get)

プロファイルパスは、次のネットワークパス形式で指定します。

\\ServerName\ProfilesFolderName\UserName

例

次の例は、資格情報を使用せずに Active Directory データベースにバインドするプログラムを示しています。

 IADsContainer *pContainer = NULL;
 IDispatch *pNewObject = NULL;
 IADsTSUserEx *pTSUser = NULL;
 IADsUser *pUser = NULL;
 HRESULT hr = ERROR_SUCCESS;

 CoInitialize(NULL);
 //
 // Bind to the known container.
 //
 hr = ADsGetObject(
    L"LDAP://DOMAIN/CN=Users,DC=Server1,DC=Domain,DC=com",
    IID_IADsContainer,
    (void**)&pContainer);

 if( !SUCCEEDED(hr)) {
  wprintf(L"ADsGetObject ret failed with 0x%x\n", hr);
  return FALSE;
 }
 //
 // Create the new Active Directory Service Interfaces User object.
 //
 hr = pContainer->Create(L"user",
                         L"cn=test3",
                         &pNewObject);
 pContainer->Release();

 if( !SUCCEEDED(hr)) {
  wprintf(L"Create ret failed with 0x%x\n", hr);
  return FALSE;
 }
 //
 // Get the IADsTSUser interface from the user object.
 //
 hr = pNewObject->QueryInterface(IID_IADsTSUserEx, (void**)&pTSUser);

 if( !SUCCEEDED(hr)) { 
  wprintf(L"QueryInterface for IADsTSUserEx failed with ret 0x%x\n",
          hr);
  return FALSE;
 }
 //
 // Get the IADsTSUser interface from the user object.
 //
 hr = pNewObject->QueryInterface(IID_IADsUser, (void**)&pUser);

 if( !SUCCEEDED(hr)) {
  wprintf(L"QueryInterface for IAsUser failed with 0x%x\n", hr);
  return FALSE;
 }
 pNewObject->Release();

 //
 // Set TerminalServicesProfilePath
 //
 pTSUser->put_TerminalServicesProfilePath(L"c:\\windows");
 pTSUser->Release();

 //
 // Commit the object data to the directory.
 //
 pUser->SetInfo();
 pUser->Release();
 CoUninitialize();

次のスクリプト例を使用して、プロバイダーの名前空間にバインドできます。2 つの例は指定した資格情報でバインドし、残りの 2 つは資格情報を使用せずにバインドします。

1 つ目の例は、指定した資格情報でセキュリティアカウントマネージャー (SAM) データベースにバインドするスクリプトを示しています。

2 つ目の例は、指定した資格情報で Active Directory データベースにバインドするスクリプトを示しています。

Set DSO = GetObject("WinNT:")
Set usr = DSO.OpenDSObject(
    "WinNT://Server1/Test,user",
    Domain\User,
    Password,
    ADS_SECURE_AUTHENTICATION)
Wscript.echo usr.TerminalServicesProfilePath
usr.TerminalServicesProfilePath = "profile path"
usr.SetInfo
WScript.echo usr.TerminalServicesProfilePath

Set DSO = GetObject("LDAP:")
Set usr = DSO.OpenDSObject(
    "LDAP://DOMAIN/CN=Test,CN=Users,DC=Server1,DC=Domain,DC=com",
    Domain\User,
    Password,
    ADS_SECURE_AUTHENTICATION)
Wscript.echo usr.TerminalServicesProfilePath
usr.TerminalServicesProfilePath = "profile path"
usr.SetInfo
WScript.echo usr.TerminalServicesProfilePath

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーにログオンするときに使用される、移動プロファイルまたは必須プロファイルのパスです。 (Put)

プロファイルパスは、次のネットワークパス形式で指定します。

\\ServerName\ProfilesFolderName\UserName

例

次の例は、資格情報を使用せずに Active Directory データベースにバインドするプログラムを示しています。

 IADsContainer *pContainer = NULL;
 IDispatch *pNewObject = NULL;
 IADsTSUserEx *pTSUser = NULL;
 IADsUser *pUser = NULL;
 HRESULT hr = ERROR_SUCCESS;

 CoInitialize(NULL);
 //
 // Bind to the known container.
 //
 hr = ADsGetObject(
    L"LDAP://DOMAIN/CN=Users,DC=Server1,DC=Domain,DC=com",
    IID_IADsContainer,
    (void**)&pContainer);

 if( !SUCCEEDED(hr)) {
  wprintf(L"ADsGetObject ret failed with 0x%x\n", hr);
  return FALSE;
 }
 //
 // Create the new Active Directory Service Interfaces User object.
 //
 hr = pContainer->Create(L"user",
                         L"cn=test3",
                         &pNewObject);
 pContainer->Release();

 if( !SUCCEEDED(hr)) {
  wprintf(L"Create ret failed with 0x%x\n", hr);
  return FALSE;
 }
 //
 // Get the IADsTSUser interface from the user object.
 //
 hr = pNewObject->QueryInterface(IID_IADsTSUserEx, (void**)&pTSUser);

 if( !SUCCEEDED(hr)) { 
  wprintf(L"QueryInterface for IADsTSUserEx failed with ret 0x%x\n",
          hr);
  return FALSE;
 }
 //
 // Get the IADsTSUser interface from the user object.
 //
 hr = pNewObject->QueryInterface(IID_IADsUser, (void**)&pUser);

 if( !SUCCEEDED(hr)) {
  wprintf(L"QueryInterface for IAsUser failed with 0x%x\n", hr);
  return FALSE;
 }
 pNewObject->Release();

 //
 // Set TerminalServicesProfilePath
 //
 pTSUser->put_TerminalServicesProfilePath(L"c:\\windows");
 pTSUser->Release();

 //
 // Commit the object data to the directory.
 //
 pUser->SetInfo();
 pUser->Release();
 CoUninitialize();

次のスクリプト例を使用して、プロバイダーの名前空間にバインドできます。2 つの例は指定した資格情報でバインドし、残りの 2 つは資格情報を使用せずにバインドします。

1 つ目の例は、指定した資格情報でセキュリティアカウントマネージャー (SAM) データベースにバインドするスクリプトを示しています。

2 つ目の例は、指定した資格情報で Active Directory データベースにバインドするスクリプトを示しています。

Set DSO = GetObject("WinNT:")
Set usr = DSO.OpenDSObject(
    "WinNT://Server1/Test,user",
    Domain\User,
    Password,
    ADS_SECURE_AUTHENTICATION)
Wscript.echo usr.TerminalServicesProfilePath
usr.TerminalServicesProfilePath = "profile path"
usr.SetInfo
WScript.echo usr.TerminalServicesProfilePath

Set DSO = GetObject("LDAP:")
Set usr = DSO.OpenDSObject(
    "LDAP://DOMAIN/CN=Test,CN=Users,DC=Server1,DC=Domain,DC=com",
    Domain\User,
    Password,
    ADS_SECURE_AUTHENTICATION)
Wscript.echo usr.TerminalServicesProfilePath
usr.TerminalServicesProfilePath = "profile path"
usr.SetInfo
WScript.echo usr.TerminalServicesProfilePath

ユーザーのルートディレクトリです。リモートデスクトップセッションホスト (RD セッションホスト) サーバー上の各ユーザーは、一意のルートディレクトリを持ちます。これにより、マルチユーザー環境でユーザーごとにアプリケーション情報が個別に保存されます。 (Get)

ローカルコンピューターにルートディレクトリを設定するには、ローカルパス (例: C:\Path) を指定します。ネットワーク環境でルートディレクトリを設定するには、まず TerminalServicesHomeDrive プロパティを設定してから、このプロパティに UNC パスを設定する必要があります。

例

例については、TerminalServicesHomeDrive を参照してください。

ユーザーのルートディレクトリです。リモートデスクトップセッションホスト (RD セッションホスト) サーバー上の各ユーザーは、一意のルートディレクトリを持ちます。これにより、マルチユーザー環境でユーザーごとにアプリケーション情報が個別に保存されます。 (Put)

ローカルコンピューターにルートディレクトリを設定するには、ローカルパス (例: C:\Path) を指定します。ネットワーク環境でルートディレクトリを設定するには、まず TerminalServicesHomeDrive プロパティを設定してから、このプロパティに UNC パスを設定する必要があります。

例

例については、TerminalServicesHomeDrive を参照してください。

ユーザーのルートドライブです。ネットワーク環境では、このプロパティは、ルートディレクトリとして指定した UNC パスのマップ先となるドライブ指定 (ドライブ文字とそれに続くコロン) を含む文字列です。 (Get)

ネットワーク環境でルートディレクトリを設定するには、まずこのプロパティを設定してから、TerminalServicesHomeDirectory プロパティを設定する必要があります。

例

次の例は、資格情報を使用せずに SAM データベースにバインドするスクリプトを示しています。

Set DSO = GetObject("WinNT:")
Set usr = DSO.OpenDSObject("WinNT://Server1/Test,user")
WScript.echo usr.TerminalServicesHomeDrive
Wscript.echo usr.TerminalServicesHomeDirectory

usr.TerminalServicesHomeDrive = "Z:"
usr.TerminalServicesHomeDirectory = "\\servername\share\path"
usr.SetInfo

WScript.echo usr.TerminalServicesHomeDrive
WScript.echo usr.TerminalServicesHomeDirectory

ユーザーのルートドライブです。ネットワーク環境では、このプロパティは、ルートディレクトリとして指定した UNC パスのマップ先となるドライブ指定 (ドライブ文字とそれに続くコロン) を含む文字列です。 (Put)

ネットワーク環境でルートディレクトリを設定するには、まずこのプロパティを設定してから、TerminalServicesHomeDirectory プロパティを設定する必要があります。

例

次の例は、資格情報を使用せずに SAM データベースにバインドするスクリプトを示しています。

Set DSO = GetObject("WinNT:")
Set usr = DSO.OpenDSObject("WinNT://Server1/Test,user")
WScript.echo usr.TerminalServicesHomeDrive
Wscript.echo usr.TerminalServicesHomeDirectory

usr.TerminalServicesHomeDrive = "Z:"
usr.TerminalServicesHomeDirectory = "\\servername\share\path"
usr.SetInfo

WScript.echo usr.TerminalServicesHomeDrive
WScript.echo usr.TerminalServicesHomeDirectory

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーへのログオンを許可されるかどうかを指定する値です。 (Get)

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーへのログオンを許可されるかどうかを指定する値です。 (Put)

ユーザーのリモートデスクトップサービスセッションのリモート監視またはリモートコントロールを許可するかどうかを指定する値です。 (Get)

ユーザーのリモートデスクトップサービスセッションのリモート監視またはリモートコントロールを許可するかどうかを指定する値です。 (Put)

切断されたリモートデスクトップサービスセッションが、リモートデスクトップセッションホスト (RD セッションホスト) サーバー上でアクティブなまま維持される最大時間です。指定した分数が経過すると、セッションは終了します。 (Get)

切断されたリモートデスクトップサービスセッションが、リモートデスクトップセッションホスト (RD セッションホスト) サーバー上でアクティブなまま維持される最大時間です。指定した分数が経過すると、セッションは終了します。 (Put)

リモートデスクトップサービスセッションの最大継続時間です。指定した分数が経過すると、セッションを切断または終了できます。 (Get)

リモートデスクトップサービスセッションの最大継続時間です。指定した分数が経過すると、セッションを切断または終了できます。 (Put)

リモートデスクトップサービスセッションがアイドル状態のまま維持できる最大時間です。指定した分数が経過すると、セッションを切断または終了できます。 (Get)

リモートデスクトップサービスセッションがアイドル状態のまま維持できる最大時間です。指定した分数が経過すると、セッションを切断または終了できます。 (Put)

切断されたリモートデスクトップサービスセッションへの再接続を許可するかどうかを指定する値です。 (Get)

切断されたリモートデスクトップサービスセッションへの再接続を許可するかどうかを指定する値です。 (Put)

リモートデスクトップサービスセッションの制限に達したときに実行するアクションを指定する値です。 (Get)

リモートデスクトップサービスセッションの制限に達したときに実行するアクションを指定する値です。 (Put)

リモートデスクトップサービスセッションの開始時に、マップされたクライアントドライブを再接続するかどうかを指定する値です。 (Get)

リモートデスクトップサービスセッションの開始時に、マップされたクライアントドライブを再接続するかどうかを指定する値です。 (Put)

ログオン時にマップされたクライアントプリンターへ再接続するかどうかを指定する値です。 (Get)

ログオン時にマップされたクライアントプリンターへ再接続するかどうかを指定する値です。 (Put)

クライアントの既定のプリンターに自動的に印刷するかどうかを指定する値です。 (Get)

クライアントの既定のプリンターに自動的に印刷するかどうかを指定する値です。 (Put)

ユーザーの作業ディレクトリのパスです。 (Get)

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーにログオンするときに起動する初期アプリケーションを設定するには、まず TerminalServicesInitialProgram プロパティを設定してから、このプロパティを設定する必要があります。

例

例については、TerminalServicesInitialProgram を参照してください。

ユーザーの作業ディレクトリのパスです。 (Put)

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーにログオンするときに起動する初期アプリケーションを設定するには、まず TerminalServicesInitialProgram プロパティを設定してから、このプロパティを設定する必要があります。

例

例については、TerminalServicesInitialProgram を参照してください。

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーにログオンするときに自動的に起動したいアプリケーションのパスとファイル名です。 (Get)

ユーザーがログオンするときに起動する初期アプリケーションを設定するには、まずこのプロパティを設定してから、TerminalServicesWorkDirectory プロパティを設定する必要があります。TerminalServicesInitialProgram プロパティのみを設定した場合、アプリケーションはユーザーのセッション内の既定のユーザーディレクトリで起動します。

例

次の例は、資格情報を使用せずに Active Directory データベースにバインドするスクリプトを示しています。

Set DSO = GetObject("LDAP:")
Set usr = DSO.OpenDSObject(
    "LDAP://DOMAIN/CN=Test,CN=Users,DC=Server1,DC=Domain,DC=com")
Wscript.echo usr.TerminalServicesWorkDirectory
Wscript.echo usr.TerminalServicesInitialProgram
usr.TerminalServicesInitialProgram= "cmd.exe"
usr.TerminalServicesWorkDirectory= "D:\path"
usr.SetInfo
WScript.echo usr.TerminalServicesInitialProgram
Wscript.echo usr.TerminalServicesWorkDirectory

ユーザーがリモートデスクトップセッションホスト (RD セッションホスト) サーバーにログオンするときに自動的に起動したいアプリケーションのパスとファイル名です。 (Put)

ユーザーがログオンするときに起動する初期アプリケーションを設定するには、まずこのプロパティを設定してから、TerminalServicesWorkDirectory プロパティを設定する必要があります。TerminalServicesInitialProgram プロパティのみを設定した場合、アプリケーションはユーザーのセッション内の既定のユーザーディレクトリで起動します。

例

次の例は、資格情報を使用せずに Active Directory データベースにバインドするスクリプトを示しています。

Set DSO = GetObject("LDAP:")
Set usr = DSO.OpenDSObject(
    "LDAP://DOMAIN/CN=Test,CN=Users,DC=Server1,DC=Domain,DC=com")
Wscript.echo usr.TerminalServicesWorkDirectory
Wscript.echo usr.TerminalServicesInitialProgram
usr.TerminalServicesInitialProgram= "cmd.exe"
usr.TerminalServicesWorkDirectory= "D:\path"
usr.SetInfo
WScript.echo usr.TerminalServicesInitialProgram
Wscript.echo usr.TerminalServicesWorkDirectory