SMS_ConfigurationPolicy Server WMI Class
The SMS_ConfigurationPolicy
Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that represents the desired values of settings declared in a subclass of SMS_SettingsDefinitionBase
. For instance, SMS_FirewallSettings
is a subclass of SMS_SettingsDefinitionBase
which declares possible settings for Windows Firewall. One such setting is "Block incoming connections on public networks." SMS_ConfigurationPolicy
could be used to set a policy on that setting, such as "The setting 'Block incoming connections on public networks' should be enabled".
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.
Syntax
Class SMS_ConfigurationPolicy : SMS_ConfigurationPolicyBase
{
UInt32 ActivatedCount;
String ApplicabilityCondition;
UInt32 AssignedCount;
String CategoryInstance_UniqueIDs[];
UInt32 CI_ID;
String CI_UniqueID;
UInt32 CIType_ID;
UInt32 CIVersion;
UInt32 ComplianceCount;
Real64 CompliantPercentage;
String CreatedBy;
DateTime DateCreated;
DateTime DateLastModified;
DateTime EffectiveDate;
UInt32 EULAAccepted;
Boolean EULAExists;
DateTime EULASignoffDate;
String EULASignoffUser;
UInt32 ExecutionContext;
UInt32 FailureCount;
Boolean IsAssigned;
Boolean IsBroken;
Boolean IsBundle;
Boolean IsDigest;
Boolean IsEnabled;
Boolean IsExpired;
Boolean IsHidden;
Boolean IsLatest;
Boolean IsQuarantined;
Boolean IsSuperseded;
Boolean IsUserDefined;
String LastModifiedBy;
String LocalizedCategoryInstanceNames[];
String LocalizedDescription;
String LocalizedDisplayName;
SMS_CI_LocalizedEulas LocalizedEulas[];
SMS_CI_LocalizedProperties LocalizedInformation[];
String LocalizedInformativeURL;
UInt32 LocalizedPropertyLocaleID;
UInt32 ModelID;
String ModelName;
UInt32 NonComplianceCount;
UInt32 PermittedUses;
String PlatformCategoryInstance_UniqueIDs[];
UInt32 PlatformType;
UInt32 Precedence;
SMS_SDMPackageLocalizedData SDMPackageLocalizedData[];
UInt32 SDMPackageVersion;
String SDMPackageXML;
String SecuredScopeNames[];
String SedoObjectVersion;
UInt32 Severity;
String SourceSite;
};
Methods
The following table lists the methods in the SMS_ConfigurationPolicy
class.
Method | Description |
---|---|
AcceptEULA Method in Class SMS_ConfigurationPolicy | Accepts or declines the Microsoft Software License Terms of a configuration item. |
GetEULA Method in Class SMS_ConfigurationPolicy | Gets the localized Microsoft Software License Terms text of the configuration item. |
Properties
ActivatedCount
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationBaselineInfo Server WMI Class.
ApplicabilityCondition
Data type: String
Access type: Read/Write
Qualifiers: [not_null, sizelimit]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
AssignedCount
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
CategoryInstance_UniqueIDs
Data type: String Array
Access type: Read/Write
Qualifiers: none
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
CI_ID
Data type: UInt32
Access type: Read/Write
Qualifiers: [key, key]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
CI_UniqueID
Data type: String
Access type: Read/Write
Qualifiers: [not_null, unique]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
CIType_ID
Data type: UInt32
Access type: Read-only
Qualifiers: [enumeration, not_null, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
CIVersion
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
ComplianceCount
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
CompliantPercentage
Data type: Real64
Access type: Read-only
Qualifiers: [not_null, read]
The property is deprecated. Use the information contained in the SMS_DeploymentSummary Server WMI Class instead.
CreatedBy
Data type: String
Access type: Read-only
Qualifiers: [not_null, read, sizelimit]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
DateCreated
Data type: DateTime
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
DateLastModified
Data type: DateTime
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
EffectiveDate
Data type: DateTime
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
EULAAccepted
Data type: UInt32
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
EULAExists
Data type: Boolean
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
EULASignoffDate
Data type: DateTime
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
EULASignoffUser
Data type: String
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
ExecutionContext
Data type: UInt32
Access type: Read-only
Qualifiers: [read, valuemap, values]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
FailureCount
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationBaselineInfo Server WMI Class.
IsAssigned
Data type: Boolean
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationBaselineInfo Server WMI Class.
IsBroken
Data type: Boolean
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationBaselineInfo Server WMI Class.
IsBundle
Data type: Boolean
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsDigest
Data type: Boolean
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsEnabled
Data type: Boolean
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsExpired
Data type: Boolean
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsHidden
Data type: Boolean
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsLatest
Data type: Boolean
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsQuarantined
Data type: Boolean
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsSuperseded
Data type: Boolean
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
IsUserDefined
Data type: Boolean
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
LastModifiedBy
Data type: String
Access type: Read-only
Qualifiers: [not_null, read, sizelimit]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
LocalizedCategoryInstanceNames
Data type: String Array
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
LocalizedDescription
Data type: String
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
LocalizedDisplayName
Data type: String
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
LocalizedEulas
Data type: SMS_CI_LocalizedEulas
Array
Access type: Read/Write
Qualifiers: [lazy]
See SMS_ConfigurationItem Server WMI Class.
LocalizedInformation
Data type: SMS_CI_LocalizedProperties
Array
Access type: Read/Write
Qualifiers: [lazy]
See SMS_ConfigurationItem Server WMI Class.
LocalizedInformativeURL
Data type: String
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
LocalizedPropertyLocaleID
Data type: UInt32
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
ModelID
Data type: UInt32
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
ModelName
Data type: String
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
NonComplianceCount
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationBaselineInfo Server WMI Class.
PermittedUses
Data type: UInt32
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
PlatformCategoryInstance_UniqueIDs
Data type: String Array
Access type: Read/Write
Qualifiers: none
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
PlatformType
Data type: UInt32
Access type: Read-only
Qualifiers: [bitmap, bitvalues, read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
Precedence
Data type: UInt32
Access type: Read/Write
Qualifiers: none
See SMS_ConfigurationPolicyBase Server WMI Class.
SDMPackageLocalizedData
Data type: SMS_SDMPackageLocalizedData
Array
Access type: Read/Write
Qualifiers: [lazy]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
SDMPackageVersion
Data type: UInt32
Access type: Read/Write
Qualifiers: [not_null]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
SDMPackageXML
Data type: String
Access type: Read/Write
Qualifiers: [lazy]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
SecuredScopeNames
Data type: String Array
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
SedoObjectVersion
Data type: String
Access type: Read-only
Qualifiers: [read]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
Severity
Data type: UInt32
Access type: Read-only
Qualifiers: [not_null, read]
See SMS_ConfigurationBaselineInfo Server WMI Class.
SourceSite
Data type: String
Access type: Read/Write
Qualifiers: [sizelimit]
See SMS_ConfigurationItemLatestBaseClass Server WMI Class.
Remarks
To create or modify an instance of SMS_ConfigurationPolicy
, the user must have the Author Policy right on each referenced instance of SMS_SettingsDefinitionBase
. For instance, a user who has the Author Policy right on SMS_FirewallSettings
but not SMS_UserStateManagementSettings
can create SMS_ConfigurationPolicy
which sets policy on firewall settings, but will get an error trying to set policy on User State Management settings.
Requirements
Runtime Requirements
For more information, see Configuration Manager Server Runtime Requirements.
Development Requirements
For more information, see Configuration Manager Server Development Requirements.