Delen via


SMS_SiteControlFile Server WMI Class

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The SMS_SiteControlFile Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that represents the site control file and contains methods to maintain version control of the site control file.

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

Class SMS_SiteControlFile : SMS_BaseClass 
{
     String BuildNumber;
     UInt32 FileType;
     String FormatVersion;
     String SCFData;
     UInt32 SerialNumber;
     String SiteCode;
};

Methods

The following table lists the methods in SMS_SiteControlFile.

Method Description

Commit

This method is obsolete.

CommitSCF Method in Class SMS_SiteControlFile

Applies changes to the Configuration Manager database. This method replaces the Commit method.

GetCurrentVersion Method in Class SMS_SiteControlFile

Retrieves the full text of the site control file from memory.

GetSessionHandle Method in Class SMS_SiteControlFile

Gets an in-memory copy of the site control file and a session handle.

Refresh

This method is obsolete.

RefreshSCF Method in Class SMS_SiteControlFile

Refreshes the in-memory copy of the site control file with any recent changes from the database. This method replaces the Refresh method.

ReleaseSessionHandle Method in Class SMS_SiteControlFile

Releases the in-memory copy of the site control file and any resources associated with the session handle.

Properties

  • BuildNumber
    Data type: String

    Access type: Read/Write

    Qualifiers: [lazy]

    Build number of the Configuration Manager installation that create the site control file. The default value is "".

  • FileType
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [key, enumeration:ToSubClass]

    Type of site control file. Possible values are listed below. Currently only the ACTUAL (1) and PROPOSED (2) values are available. PROPOSED is the default value.

    0

    EMPTY (deprecated)

    1

    ACTUAL

    2

    PROPOSED

    4

    TRANSACTIONS (deprecated)

    6

    LOCAL_TRANSACTIONS (deprecated)

    7

    1XSTYLE (deprecated)

  • FormatVersion
    Data type: String

    Access type: Read/Write

    Qualifiers: [lazy]

    Version of the site control file format. The default value is "".

  • SCFData
    Data type: String

    Access type: Read/Write

    Qualifiers: [lazy, large]

    Current site control file data in text format (accumulated deltas).

  • SerialNumber
    Data type: UInt32

    Access type: ReadWrite

    Qualifiers: [key]

    Unique ID of the file itself. The number is incremented every time the file changes. The default value is 0.

  • SiteCode
    Data type: String

    Access type: Read-only

    Qualifiers: [key, read, SizeLimit("3")]

    Site code of the site associated with the site control file. The default value is "".

Remarks

Class qualifiers for this class include:

  • Read (read-only)

For more information about both the class qualifiers and the property qualifiers included in the Properties section, see Configuration Manager Class and Property Qualifiers.

Your application uses the methods of this class to perform version control of the site control file. To update the contents of the site control file, the application should use classes derived from SMS_SiteControlItem Server WMI Class.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

See Also

Concepts

Configuration Manager Site Configuration Server WMI Classes
SMS_SiteControlItem Server WMI Class
About the Configuration Manager Site Control File
Configuration Manager Context Qualifiers