SetUserAuthenticationRequired method of the Win32_TSGeneralSetting class
Enables or disables the requirement that users must be authenticated at connection time by setting the value of the UserAuthenticationRequired property in the Win32_TSGeneralSetting class. If True, which means enabled, UserAuthenticationRequired requires user authentication at connection time to increase server protection against network attacks. Only Remote Desktop Protocol (RDP) clients that support RDP version 6.0 or higher are able to connect. To avoid disruptions for remote users, it is recommended that you deploy RDP clients supporting the appropriate protocol version before you enable the property.
Syntax
uint32 SetUserAuthenticationRequired(
[in] uint32 UserAuthenticationRequired
);
Parameters
-
UserAuthenticationRequired [in]
-
Indicates whether user authentication is required.
-
0 (0x0)
-
Disable requirement that user must be authenticated
-
1 (0x1)
-
Enables requirement that user must be authenticated.
Return value
Returns 0 on success, otherwise returns a WMI error code. Refer to Remote Desktop Services WMI Provider Error Codes for a list of these values.
Remarks
Managed Object Format (MOF) files contain the definitions for Windows Management Instrumentation (WMI) classes. MOF files are not installed as part of the Microsoft Windows Software Development Kit (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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for