Win32_TSPermissionsSetting Class

The Win32_TSPermissionsSetting WMI class includes a method to add new accounts to the terminal and a method to restore the default permissions to a terminal.

The following syntax is simplified from MOF code and includes all defined and inherited properties, in alphabetical order. For reference information on methods, see the table of methods later in this topic.

Syntax

[dynamic, provider("Win32_WIN32_TSPERMISSIONSETTING_Prov")]class Win32_TSPermissionsSetting : Win32_TerminalSetting
{
  string Caption;
  string Description;
  uint32 DenyAdminPermissionForCustomization;
  uint32 PolicySourceDenyAdminPermissionForCustomization;
  string SettingID;
  string StringSecurityDescriptor;
  string TerminalName;
};

Methods

The Win32_TSPermissionsSetting class defines the following methods.

MethodDescription

AddAccount

Adds an account to the terminal with the permission set specified in the value of the PermissionPreSet parameter.

RestoreDefaults

Restores the default permission set values for the terminal.

 

Properties

The Win32_TSPermissionsSetting class defines the following properties.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen(64)

Short textual description (one-line string) of the CIM_Setting object. This property is inherited from CIM_Setting.

DenyAdminPermissionForCustomization
Data type: uint32
Access type: Read-only

Specifies whether local administrator has permission to customize.

Windows Server 2003 and Windows XP:  This property is not available.
Description
Data type: string
Access type: Read-only

Description of the CIM_Setting object. This property is inherited from CIM_Setting.

PolicySourceDenyAdminPermissionForCustomization
Data type: uint32
Access type: Read-only

Indicates whether the MinEncryptionLevel property is configured by the server, group policy, or by default.

Windows Server 2003 and Windows XP:  This property is not available.
ValueMeaning
0

Server

1

Group policy

 

SettingID
Data type: string
Access type: Read-only
Qualifiers: MaxLen(256)

Identifier by which the CIM_Setting object is known. This property is inherited from CIM_Setting.

StringSecurityDescriptor
Data type: string
Access type: Read/write

Security descriptor associated with the terminal in binary byte array format.

Windows Server 2003 and Windows XP:  This property is not available.
TerminalName
Data type: string
Access type: Read-only
Qualifiers: Key

The name of the terminal.

Remarks

To connect to the \root\CIMV2\TerminalServices namespace, the authentication level must include packet privacy. For C/C++ calls, this is an authentication level of RPC_C_AUTHN_LEVEL_PKT_PRIVACY. For Visual Basic and scripting calls, this is an authentication level of WbemAuthenticationLevelPktPrivacy or "pktPrivacy", with a value of 6. The following Visual Basic Scripting Edition (VBScript) example shows how to connect to a remote computer with packet privacy.

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

Managed Object Format (MOF) files contain the definitions for Windows Management Instrumentation (WMI) classes. MOF files are not installed as part of the Windows SDK. They are installed on the server when you add the associated role by using the Server Manager. For more information about MOF files, see Managed Object Format (MOF).

Requirements

Minimum supported clientWindows XP
Minimum supported serverWindows Server 2003
MOFTscfgwmi.mof
DLLTscfgwmi.dll
Namespace\root\CIMV2\TerminalServices on Windows Vista and Windows Server 2008\root\CIMV2 on Windows XP and Windows Server 2003

See Also

Win32_TerminalSetting

Send comments about this topic to Microsoft

Build date: 10/19/2009

Tags :


Page view tracker