The SMS_RemoteToolsAgentConfig Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that specifies the Remote Control settings on client computers.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

Class SMS_RemoteToolsAgentConfig : SMS_ClientAgentConfig_BaseClass
{
	UInt32 AccessLevel;
	UInt32 AgentID;
	Boolean AllowClientChange;
	Boolean AllowLocalAdminToDoRemoteControl;
	Boolean AllowRAUnsolicitedControl;
	Boolean AllowRAUnsolicitedView;
	Boolean AllowRemCtrlToUnattended;
	UInt32 AudibleSignal;
	Boolean Enabled;
	Boolean EnableRA;
	Boolean EnableTS;
	Boolean EnforceRAandTSSettings;
	UInt32 FirewallExceptionProfiles;
	Boolean ManageRA;
	Boolean ManageTS;
	Boolean PermissionRequired;
	String PermittedViewers[];
	Boolean RemCtrlConnectionBar;
	Boolean RemCtrlTaskbarIcon;
	Boolean TSUserAuthentication;
};

Methods

The SMS_RemoteToolsAgentConfig class does not define any methods.

Properties

AccessLevel

Data type: UInt32Access type: Read/Write Qualifiers: noneAccess level allowed.

No Access

View Only

Full Control
AgentID

Data type: UInt32Access type: Read-only Qualifiers: [key, read]Identifies the client agent component. The Remote Tools Agent Config ID is 3.
AllowClientChange

Data type: BooleanAccess type: Read/Write Qualifiers: noneUsers can change policy or notification settings in Software Center.
AllowLocalAdminToDoRemoteControl

Data type: BooleanAccess type: Read/Write Qualifiers: noneGrant Remote Control permission to local Administrators group.
AllowRAUnsolicitedControl

Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if the client should configure Remote Assistance to allow a remote Unsolicited Control request.
AllowRAUnsolicitedView

Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if the client should configure Remote Assistance to allow a remote Unsolicited View request.
AllowRemCtrlToUnattended

Data type: BooleanAccess type: Read/Write Qualifiers: noneAllow Remote Control of an unattended computer.
AudibleSignal

Data type: UInt32Access type: Read/Write Qualifiers: noneValue indicating if a control beep should be sounded during a remote control session to signify that the computer is being remotely controlled. This is only for Remote Control, not Remote Assistance. Possible values are:

0

None

1

Beginning and end of the session

2

Repeatedly
Enabled

Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if the agent is enabled.
EnableRA

Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if the client should enable Remote Assistance for the client.
EnableTS

Data type: BooleanAccess type: Read/Write Qualifiers: noneThis applied to the remote control setting ‘Allow permitted viewers to connect using Remote Desktop Connection at admin console UI item. This property can be set only when ManageTS is true.
EnforceRAandTSSettings

Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if Remote Assistance settings, which might be configured by the user in a Control Panel program, should be overridden by the Configuration Manager settings. This matches ‘Manage solicited Remote Assistance settings’.
FirewallExceptionProfiles

Data type: UInt32Access type: Read/Write Qualifiers: noneFirewall profile setting masks which is combine them as an OR of domain profile 0x4, private profile 0x2, and public profile 0x1.
ManageRA

Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if the client should set local Remote Assistance settings. This matches ‘Manage unsolicited Remote Assistance settings’.
ManageTS

Data type: BooleanAccess type: Read/Write Qualifiers: noneConfiguration Manager will manage Remote Desktop settings. This applies to the ‘Manage Remote Desktop Settings’ in the Admin Console’s remote desktop settings.
PermissionRequired

Data type: BooleanAccess type: Read/Write Qualifiers: noneValue indicating that the helpdesk administrator is required to get permission from the remote user before starting remote control session. This is only applied when remote user is on an active session.

false

Bypass remote control permission dialog.

true

Ask permission to start a remote control session.
PermittedViewers

Data type: String Array Access type: Read/Write Qualifiers: noneThe list of user and group names that are allowed to use Remote Tools and Remote Assistance for the client. The format of the string is <domain or computer>\<user or group name>.
RemCtrlConnectionBar

Data type: BooleanAccess type: Read/Write Qualifiers: noneShow session connection bar.
RemCtrlTaskbarIcon

Data type: BooleanAccess type: Read/Write Qualifiers: noneShow session notification icon on taskbar.
TSUserAuthentication

Data type: BooleanAccess type: Read/Write Qualifiers: noneAllow connection only from computers running Remote Desktop with network-level authentication selected in Vista or later OSs. This can be set only if EnableTS is true.

Remarks

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.