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.
| Method | Description |
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.
| Value | Meaning |
- 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 client | Windows XP |
| Minimum supported server | Windows Server 2003 |
| MOF | Tscfgwmi.mof |
| DLL | Tscfgwmi.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