RSOP_ApplicationManagementPolicySetting class

Article
05/31/2018

Represents the policy data for application management extension. For more information about this class, see Application Management Policy.

Note

Classes that derive from the RSOP_PolicySetting class must redefine both the id and the precedence properties to be keys.

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

Syntax

[AMENDMENT]
class RSOP_ApplicationManagementPolicySetting : RSOP_PolicySetting
{
  string   id;
  uint32   precedence;
  string   name = "";
  string   GPOID = "";
  string   SOMID = "";
  datetime creationTime;
  uint32   EntryType;
  string   ApplicationId;
  uint32   PackageType;
  string   ProductId;
  string   Publisher;
  string   PackageLocation;
  string   ScriptFile;
  string   Categories[];
  uint32   PrecedenceReason;
  uint32   VersionNumberLo;
  uint32   VersionNumberHi;
  uint32   RedeployCount;
  datetime DeploymentLastModifyTime;
  uint8    SecurityDescriptor[];
  uint32   MachineArchitectures[];
  uint32   LanguageId;
  uint32   DeploymentType;
  uint32   AssignmentType;
  uint32   InstallationUI;
  boolean  DemandInstallable;
  boolean  AllowX86OnIA64;
  uint32   LossOfScopeAction;
  boolean  UninstallUnmanaged;
  boolean  DisplayInARP;
  boolean  IgnoreLanguage;
  string   Transforms[];
  string   SupportURL;
  string   ReplaceableApplications[];
  string   UpgradeableApplications[];
  boolean  UpgradeSettingsMandatory;
  uint32   Eligibility;
  uint32   ApplyCause;
  uint32   LanguageMatch;
  string   OnDemandFileExtension;
  string   OnDemandClsid;
  string   OnDemandProgId;
  uint32   RemovalCause;
  uint32   RemovalType;
  string   RemovingApplication;
};

Members

The RSOP_ApplicationManagementPolicySetting class has these types of members:

Properties

Properties

The RSOP_ApplicationManagementPolicySetting class has these properties.

AllowX86OnIA64

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("AllowX86OnIA64")

If this is an X86-only application, this property is TRUE if the application can be deployed to a computer with a 64-bit processor. If this property is FALSE, the application cannot be deployed to the 64-bit platform.

ApplicationId

Data type: string
Access type: Read-only
Qualifiers: key, DisplayName ("Application Id")

GUID that identifies this application.

ApplyCause

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Apply Cause")

The situation that triggered the installation of the application.

This property can have one of the following values.

Assignment (1)

The application was assigned.

User (2)

A user installed the application through Add or Remove Programs on the Control Panel.

Profile (3)

The application was installed in the user's profile.

Extension (4)

The application was installed using file name extension activation.

Clsid (5)

The application was installed using CLSID activation.

Upgrade (6)

The installation was a forced upgrade, at logon, of a locally installed application.

ProgId (7)

The application was installed using ProgID activation.

None (8)

The application was re-deployed.

Note that this property is only set if the EntryType property is equal to the value "Applied".

AssignmentType

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Assignment Type")

For assigned applications, this property indicates whether or not this is a full installation or an advertised application.

This property can have one of the following values.

NotAssigned (1)

This is not an assigned application.

Standard (2)

This is an advertised application.

Install (3)

This application is fully installed at logon.

Categories

Data type: string array
Access type: Read-only
Qualifiers: DisplayName ("Categories")

A list of category IDs (GUIDs) for categories that apply to this application. Each GUID corresponds to one of the CategoryId attributes of an instance of the RSOP_ApplicationManagementCategory class.

creationTime

Data type: datetime
Access type: Read-only

Time the policy object was created.

Inherited from RSOP_PolicySetting.

DemandInstallable

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Demand Installable")

If this property is TRUE, the application can be installed using CLSID activation or file name extension activation. If FALSE, the application cannot be used for this purpose.

DeploymentLastModifyTime

Data type: datetime
Access type: Read-only
Qualifiers: DisplayName ("Deployment Last Modify Time")

The last time this application was modified by the administrator.

DeploymentType

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Deployment Type")

Whether the application is assigned or published.

This property can have one of the following values.

Assigned (1)

Published (2)

DisplayInARP

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Display In ARP")

If TRUE, this application can be displayed by Add or Remove Programs on the Control Panel. If FALSE, it will not displayed.

Eligibility

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Eligibility")

Reason why this software application is included in the RSoP data.

This property can have one of the following values.

Assignment (1)

The application was assigned.

Applied (2)

The application was applied to the user's profile.

Upgrades (3)

The application had potential upgrades for other applied settings.

Conditional (4)

The application is included in the RSoP data in logging mode if the application has already been applied to the target. (Used in planning mode only.)

For more information about this property, see Application Management Policy.

EntryType

Data type: uint32
Access type: Read-only
Qualifiers: key, DisplayName ("Entry Type")

Describes the contents of the instance. For more information, see the ApplyCause property of this class.

This property can have one of the following values.

Applied (1)

This is an applied application.

Removed (2)

This is a removed application.

ARP (3)

This is an item from the list displayed by Add or Remove Programs on the Control Panel.

For more information about this property, see Application Management Policy.

GPOID

Data type: string
Access type: Read-only

Identifies the GPO that contains the policy object. You can obtain this value from PGROUP_POLICY_OBJECT->lpDSPath. You must remove the prefix LDAP://CN=Machine from lpDSPath.

Inherited from RSOP_PolicySetting.

Data type: string
Access type: Read-only
Qualifiers: key, DisplayName ("ID")

Unique identifier for objects of this class.

Inherited from RSOP_PolicySetting. For more information about this property, see Application Management Policy.

IgnoreLanguage

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Ignore Language")

If TRUE, language is ignored when determining whether this application applies to a user or to a computer. If FALSE, language is considered.

InstallationUI

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Installation UI")

The user interface level of the install. This property can have one of the following values.

This property can have one of the following values.

Basic (1)

Maximum (2)

LanguageId

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Language Id")

The Windows language ID for the language supported by the application.

LanguageMatch

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Language Match")

Specifies how the application's language was matched to the system. This property can have one of the following values.

System (1)

System. The application language matched the system language.

English (2)

English. The application language was English.

Ignore (3)

Ignore. Since the application had the IgnoreLanguage property set, no match was necessary.

Neutral (4)

Neutral. The application was language-neutral.

None (5)

None. The language did not match.

LossOfScopeAction

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Loss Of Scope Action")

Determines the behavior of the software when the GPO for the application is out of scope.

This property can have one of the following values.

Uninstall (1)

Unmanage (2)

MachineArchitectures

Data type: uint32 array
Access type: Read-only
Qualifiers: DisplayName ("Machine Architectures")

A list of computer architectures supported by the application.

name

Data type: string
Access type: Read-only

User-friendly name of the policy object.

Inherited from RSOP_PolicySetting.

OnDemandClsid

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("On Demand Clsid")

If the application was installed using an on-demand installation through a COM activation for a CLSID, this property specifies the CLSID that caused the installation.

OnDemandFileExtension

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("On Demand File Extension")

If the application was installed using an on-demand installation by a file name extension, this property specifies the file name extension that caused the installation.

OnDemandProgId

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("On Demand Prog Id")

If the application was installed using an on-demand installation through a COM activation for ProgID, this property specifies the ProgID that caused the installation.

PackageLocation

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Package Location")

For Windows Installer packages, the file system path to the Windows Installer package. For ZAP packages, the path to the Setup.exe program.

PackageType

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Package Type")

Describes the actual package to install.

This property can have one of the following values.

WindowsInstaller (1)

ZAP (2)

precedence

Data type: uint32
Access type: Read-only
Qualifiers: key, DisplayName ("Precedence")

The order or precedence in which the policy setting should be applied.

Inherited from RSOP_PolicySetting. For more information about this property, see Application Management Policy.

PrecedenceReason

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Precedence Reason")

If this application has a lower precedence than another application, this property specifies the reason why this application has a lower precedence than the application with the next highest precedence. This property can have one of the following values.

Language (1)

This application's language is a better match for the target.

Product (2)

This application's ProdID conflicts with the losing application.

Time (3)

TBD

Upgrade (4)

This application upgrades the losing application.

Highest (5)

This application is the winning application.

NonForced (6)

Although the application upgraded the "winning" application, the upgrade was an optional one rather than a required one.

For more information about this property, see Application Management Policy.

ProductId

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Product Id")

The Windows Installer product code, a unique ID for the software product.

Publisher

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("")

Name of the software's vendor.

RedeployCount

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Redeploy Count")

The number of times this application has been re-deployed.

RemovalCause

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Removal Cause")

The situation that caused the removal of the application. This property can have one of the following values.

None (1)

None. The application was not removed.

Upgraded (2)

Upgraded. The application was upgraded.

Administrative (3)

Administrative. The application was removed by the administrator.

User (4)

User. The application was removed by the user.

Scope (5)

Scope. The application went out of scope.

Transform (6)

Transform. The application was removed due to a transform file conflict.

Product (7)

Product. The application was removed due to a product conflict.

Profile (8)

Profile. The application was removed from the computer of interest because the application was removed from the user's profile on another computer from which the profile roamed.

RemovalType

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Removal Type")

Describes the manner in which this application ceased to be applied. This property can have one of the following values.

Not Removed (1)

Upgraded (2)

Uninstalled (3)

Unmanaged (4)

RemovingApplication

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Removing Application")

A GUID corresponding to the ApplicationId property of the RSOP_ApplicationManagementPolicySetting class for the application that caused this application to no longer apply to the target.

ReplaceableApplications

Data type: string array
Access type: Read-only
Qualifiers: DisplayName ("Replaceable Applications")

A list of application IDs (GUIDs) for applications that can be replaced (uninstalled) by this application. Each GUID corresponds to the ApplicationId property of an instance of this class.

ScriptFile

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Script File")

A fully qualified path to the Windows Installer advertisement script.

SecurityDescriptor

Data type: uint8 array
Access type: Read-only
Qualifiers: DisplayName ("Security Descriptor")

Array of bytes containing the security descriptor associated with the deployed application. The security descriptor is in self-relative format. For more information, see Absolute and Self-Relative Security Descriptors.

SOMID

Data type: string
Access type: Read-only

The scope of management (SOM) associated with the GPO that contains this policy object. You can obtain this value from PGROUP_POLICY_OBJECT->lpLink. You must remove the prefix LDAP:// from lpLink.

Inherited from RSOP_PolicySetting.

SupportURL

Data type: string
Access type: Read-only
Qualifiers: DisplayName ("SupportURL")

A URL for presentation to the user when support for the application is required.

Transforms

Data type: string array
Access type: Read-only
Qualifiers: DisplayName ("Transforms")

A list of file system paths to Windows Installer transform files used to modify the application.

UninstallUnmanaged

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Uninstall Unmanaged")

If this property is TRUE, in order to install, this application will remove unmanaged applications with the same Windows Installer ProdID that are currently installed.

UpgradeableApplications

Data type: string array
Access type: Read-only
Qualifiers: DisplayName ("Upgradeable Applications")

A list of application IDs (GUIDs) for applications that can be upgraded (installed over) by applying this application. Each ID corresponds to the ApplicationId property of an instance of this class.

UpgradeSettingsMandatory

Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Upgrade Settings Mandatory")

If this property is TRUE, it indicates that currently installed applications will be forcibly upgraded if this application is applied. If this property is FALSE, it indicates that currently installed applications will not be forcibly upgraded by this application.

VersionNumberHi

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Version Number Hi")

Major version number of the application. For Windows Installer applications, the number is extracted from the package's version by the Software Installation extension to Group Policy.

VersionNumberLo

Data type: uint32
Access type: Read-only
Qualifiers: DisplayName ("Version Number Lo")

Minor version number of the application. For Windows Installer applications, the number is extracted from the package's version by the Software Installation extension to Group Policy.

Remarks

The RSOP_ApplicationManagementPolicySetting class is derived from RSOP_PolicySetting.

Requirements


Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\RSOP\Computer, Root\RSOP\User
MOF	Rsop.mof
DLL	GPSvc.dll

Partager via

RSOP_ApplicationManagementPolicySetting class

Syntax

Members

Properties

Remarks

Requirements

See also

Ressources supplémentaires