GetPolicyState Method in Class CCM_SoftwareCatalogUtilities

The GetPolicyState Windows Management Instrumentation (WMI) class method, in Configuration Manager, that returns the state of a policy object.

The following syntax is simplified from Managed Object Format (MOF) code and defines the method.


uint32 GetPolicyState { [IN] String Id [OUT] UInt32 Status [OUT] UInt32 State };

Parameters

Id: Data type: StringQualifiers: [id("0"), in]Unique ID of the policy object.

State

Data type: UInt32Qualifiers: [id("2"), out]Current state of the policy object. Possible values are:

NULL	The policy object is inactive and has not been downloaded. This is the default value.
DownloadPending	The evaluator has determined that the policy object needs to be applied and should be downloaded. This is a temporary state used during the evaluation process.
DownloadStarted	The policy object has been requested from the management point and is in the process of being downloaded.
DownloadComplete	The policy object has finished downloading from the management point but has not been compiled into WMI yet.
Inactive	The policy object is downloaded and compiled, but has no active assignments.
Applied	The policy object is currently active, but pending re-valuation. This is a temporary state used during the evaluation process. If the evaluation determines that the policy object should no longer be active, its actions must be revoked.
ApplyPending	The policy object is currently inactive, but now has active assignments and actions that should be applied. This is a temporary state used during the evaluation process.
Active	The policy object is currently active and has been applied.
NotApplicable	The policy object is not applicable. This information applies only to System Center 2012 Configuration Manager SP1 and System Center 2012 R2 Configuration Manager.