SMS_PolicyAgentConfig server WMI class

The SMS_PolicyAgentConfig WMI class is an SMS Provider server class in Configuration Manager. It represents how the client policy system is configured. These settings affect which policies are retrieved, when and how often they're retrieved, and how the client policy processing component takes action on policy updates.

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

Syntax

Class SMS_PolicyAgentConfig : SMS_ClientAgentConfig_BaseClass  
{  
    UInt32 AgentID;  
    String PolicyDownloadMethod;  
    Boolean PolicyEnableUserAuthForAllUserPolicies;  
    Boolean PolicyEnableUserGroupSupport;  
    Boolean PolicyEnableUserPolicyOnInternet;  
    Boolean PolicyEnableUserPolicyOnTS;  
    Boolean PolicyEnableUserPolicyPolling;  
    UInt32 PolicyRequestAssignmentTimeout;  
    UInt32 PolicyTimeDelayBeforeUserPolicyRefreshAtLogonOrUnlock;  
    UInt32 PolicyTimeUntilAck;  
    UInt32 PolicyTimeUntilExpire;  
    UInt32 PolicyTimeUntilUpdateActualConfig;  
};  

Methods

The SMS_PolicyAgentConfig class doesn't define any methods.

Properties

AgentID

Data type: UInt32

Access type: Read-only

Qualifiers: [key, read]

Identifies the client agent component. The policy agent ID is 13.

PolicyDownloadMethod

Data type: String

Access type: Read/Write

Qualifiers: none

Method used by the policy agent to download policy files. Possible values are listed below. This value can only be NULL if PolicyRequestTarget is NULL. This value shouldn't be changed.

Value Policy download method
FILECOPY Copy policy files using standard file copy operations. Policy paths must be local or Universal Naming Convention (UNC) file paths. This value is intended for testing only.
HTTP Download policy files synchronously by using direct HTTP. Policy paths must be HTTP URLs.
BITS Drizzle policy files asynchronously by using the Data Transfer Service. Policy paths must be HTTP URLs.

PolicyEnableUserAuthForAllUserPolicies

Data type: Boolean

Access type: Read/Write

Qualifiers: none

true when the policy agent requests policies specific for users on the computer and enforces user authentication with the management point.

PolicyEnableUserGroupSupport

Data type: Boolean

Access type: Read/Write

Qualifiers: none

true if the Policy Agent sends user group information when requesting a user policy.

PolicyEnableUserPolicyOnInternet

Data type: Boolean

Access type: Read/Write

Qualifiers: none

true to enable user policy requests from internet clients.

PolicyEnableUserPolicyOnTS

Data type: Boolean

Access type: Read/Write

Qualifiers: none

Starting in version 1906, set to true to enable user policy on a terminal server, such as Windows Virtual Desktop. User policy is disabled by default on these devices to help client performance. If you enable this property, you accept any potential performance impact to these devices.

If PolicyEnableUserPolicyPolling is false, this property is ignored.

PolicyEnableUserPolicyPolling

Data type: Boolean

Access type: Read/Write

Qualifiers: none

true to enable user policy polling.

PolicyRequestAssignmentTimeout

Data type: UInt32

Access type: Read/Write

Qualifiers: none

Timeout for the policy request assignment.

PolicyTimeDelayBeforeUserPolicyRefreshAtLogonOrUnlock

Data type: UInt32

Access type: Read/Write

Qualifiers: none

The amount of time in milliseconds before the policy agent automatically retrieves new user policies after the user signs in or unlocks the desktop.

PolicyTimeUntilAck

Data type: UInt32

Access type: Read/Write

Qualifiers: none

The time that must elapse before the policy is acknowledged.

PolicyTimeUntilExpire

Data type: UInt32

Access type: Read/Write

Qualifiers: none

The number of days that the policy agent should wait since it last received a ReplyAssignments message from the authority before removing its policy. At half this time, the policy agent begins requesting acknowledgments. If this value is NULL, the policy never expires.

PolicyTimeUntilUpdateActualConfig

Data type: UInt32

Access type: Read/Write

Qualifiers: none

The time that must elapse before the actual configuration is updated.

Runtime requirements

For more information, see Configuration Manager server runtime requirements.

Development requirements

For more information, see Configuration Manager server development requirements.