ImportMachineEntry Method in Class SMS_Site

  • Article

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 ImportMachineEntry Windows Management Instrumentation (WMI) class method, in Configuration Manager, imports computer information.

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

 
SInt32 ImportMachineEntry( 
     String NetbiosName, 
     String SMBIOSGUID, 
     String MACAddress, 
     Boolean OverwriteExistingRecord,
     String FQDN,
     Boolean IsAMTMachine,
     String MEBxPassword,
     String AdminPassword,
     Boolean MachineExists, 
     UInt32 ResourceID, 
     String SMSUniqueIdentifier 
);

Parameters

  • NetbiosName
    Data type: String

    Qualifiers: [in]

    The NetBIOS name for the computer.

  • SMBIOSGUID
    Data type: String

    Qualifiers: [in]

    The GUID for the system management BIOS (SMBIOS).

  • MACAddress
    Data type: String

    Qualifiers: [in]

    The media access controller (MAC) address. The MAC address must be for a network adapter that has a driver in Windows PE. The MAC address must be in colon format. For example, 00:00:00:00:00:00. Other formats prevent the client from receiving policy.

  • OverwriteExistingRecord
    Data type: Boolean

    Qualifiers: [in]

    true to overwrite the existing record.

  • FQDN
    Data type: String

    Qualifiers: [in, optional]

    Fully qualified domain name of this computer.

  • IsAMTMachine
    Data type: Boolean

    Qualifiers: [in, optional]

    Enable out of band functionality on this computer.

  • MEBxPassword
    Data type: String

    Qualifiers: [in, optional]

    Management Engine BIOS extension (MEBx) password for the built-in Intel Active Management Technology (Intel AMT) firmware administrative user.

  • AdminPassword
    Data type: String

    Qualifiers: [in, optional]

    The changed password of the MEBx password that can occur during out of band provisioning.

  • MachineExists
    Data type: Boolean

    Qualifiers: [out]

    true if the computer exists.

  • ResourceID
    Data type: UInt32

    Qualifiers: [out]

    Resource ID for the computer.

  • SMSUniqueIdentifier
    Data type: String

    Qualifiers: [out]

    Unique ID of Configuration Manager.

Return Values

An SInt32 data type that is 0 to indicate success or non-zero to indicate failure.

For information about handling returned errors, see About Configuration Manager Errors.

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

Reference

SMS_Site Server WMI Class