Freigeben über

Konfigurieren von Hardwareinventureinstellungen

Sie legen die Einstellungen des Client-Agents für die Hardwareinventur in Configuration Manager fest, indem Sie die erforderlichen Einstellungen für die Standortsteuerungsdatei ändern.

So ändern Sie die Einstellungen des Client-Agents für die Hardwareinventur

  1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein.

  2. Stellen Sie eine Verbindung mit dem Abschnitt HardwareInventurclient-Agent der Standortsteuerungsdatei her, indem Sie die klasse SMS_SCI_ClientComp verwenden.

  3. Durchlaufen Sie das Array der verfügbaren Eigenschaften, und nehmen Sie nach Bedarf Änderungen vor.

  4. Committen Sie die Änderungen an der Websitesteuerungsdatei.

Beispiel

Im folgenden Beispiel werden die Einstellungen des Hardwareinventurclient-Agents mithilfe der klasse SMS_SCI_ClientComp festgelegt, um eine Verbindung mit der Standortsteuerungsdatei herzustellen und die Eigenschaften zu ändern.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager Codeausschnitten.


Sub ConfigureHardwareInventoryClientAgentSettings(swbemServices,        _  
                                                  swbemContext,         _  
                                                  siteCode,             _  
                                                  newInventorySchedule, _  
                                                  newMIFSize,           _   
                                                  newMIFCollection)  

    ' Load site control file and get the SMS Software Update Point system resource section.  
    swbemServices.ExecMethod "SMS_SiteControlFile.Filetype=1,Sitecode=""" & siteCode & """", "Refresh", , , swbemContext  

    Query = "SELECT * FROM SMS_SCI_ClientComp " & _  
    "WHERE ClientComponentName = 'Hardware Inventory Agent' " & _  
    "AND SiteCode = '" & siteCode & "'"            

    Set SCIComponentSet = swbemServices.ExecQuery(Query, ,wbemFlagForwardOnly Or wbemFlagReturnImmediately, swbemContext)  

    ' Only one instance is returned from the query.  
    For Each SCIComponent In SCIComponentSet  

        ' Set the client agent by setting the Flags value to 0 or 1 using the enableDisableClientAgent variable.  
        wscript.echo " "  
        wscript.echo "Hardware Inventory Agent"  
        wscript.echo "Current value " &  SCIComponent.Flags  

        ' Modify the value.                  
        SCIComponent.Flags = enableDisableClientAgent  
        wscript.echo "New value " & enableDisableClientAgent  

        'Loop through the array of embedded SMS_EmbeddedProperty instances.  
        For Each vProperty In SCIComponent.Props  

            ' Setting: Inventory Schedule  
            If vProperty.PropertyName = "Inventory Schedule" Then  
                wscript.echo " "  
                wscript.echo vProperty.PropertyName  
                wscript.echo "Current value " &  vProperty.Value2                 

                'Modify the value.  
                vProperty.Value2 = newInventorySchedule  
                wscript.echo "New value " & newInventorySchedule  
            End If  

            ' Setting: Maximum 3rd Party MIF Size  
            If vProperty.PropertyName = "Maximum 3rd Party MIF Size" Then  
                wscript.echo " "  
                wscript.echo vProperty.PropertyName  
                wscript.echo "Current value " &  vProperty.Value                 

                ' Modify the value.  
                vProperty.Value = newMIFSize  
                wscript.echo "New value " & newMIFSize  
            End If  

            ' Setting: MIF Collection  
            If vProperty.PropertyName = "MIF Collection" Then  
                wscript.echo " "  
                wscript.echo vProperty.PropertyName  
                wscript.echo "Current value " &  vProperty.Value                 

                ' Modify the value.  
                vProperty.Value = newMIFCollection  
                wscript.echo "New value " & newMIFCollection  
            End If  

        Next     

        ' Update the component in your copy of the site control file. Get the path  
        'to the updated object, which could be used later to retrieve the instance.  
        Set SCICompPath = SCIComponent.Put_(wbemChangeFlagUpdateOnly, swbemContext)  

    Next  

    ' Commit the change to the actual site control file.  
    Set InParams = swbemServices.Get("SMS_SiteControlFile").Methods_("CommitSCF").InParameters.SpawnInstance_  
    InParams.SiteCode = siteCode  
    swbemServices.ExecMethod "SMS_SiteControlFile", "CommitSCF", InParams, , swbemContext  

End Sub  


public void ConfigureHardwareInventoryClientAgentSettings(WqlConnectionManager connection,  
                                                    string siteCode,  
                                                    string enableDisableClientAgent,  
                                                    string newInventorySchedule,  
                                                    string newMIFSize,  
                                                    string newMIFCollection)  
{  
    try  
    {  
        IResultObject siteDefinition = connection.GetInstance(@"SMS_SCI_ClientComp.FileType=1,ItemType='Client Component',SiteCode='" + siteCode + "',ItemName='Hardware Inventory Agent'");  

        // Setting: Enable Client Agent  
        // Enable or disable the client agent by setting the Flags value to 0 or 1 using the enableDisableClientAgent variable.   
        Console.WriteLine();  
        Console.WriteLine("Hardware Inventory Client Agent");  
        Console.WriteLine("Current value: " + siteDefinition["Flags"].StringValue);  

        // Change value using the enableDisableClientAgent value passed in.   
        siteDefinition["Flags"].StringValue = enableDisableClientAgent;  
        Console.WriteLine("New value    : " + enableDisableClientAgent);  

        foreach (KeyValuePair<string, IResultObject> kvp in siteDefinition.EmbeddedProperties)  
        {  
            // Create temporary working copy of embedded properties.  
            Dictionary<string, IResultObject> embeddedProperties = siteDefinition.EmbeddedProperties;  

            // Setting: Inventory Schedule  
            if (kvp.Value.PropertyList["PropertyName"] == "Inventory Schedule")  
            {  
                Console.WriteLine();  
                Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);  
                Console.WriteLine("Current value: " + kvp.Value.PropertyList["PropertyName"]);  

                // Change value using the newInventorySchedule value passed in.   
                embeddedProperties["Inventory Schedule"]["Value2"].StringValue = newInventorySchedule;  
                Console.WriteLine("New value    : " + newInventorySchedule);  
            }  

            // Setting: Maximum 3rd Party MIF Size  
            if (kvp.Value.PropertyList["PropertyName"] == "Maximum 3rd Party MIF Size")  
            {  
                Console.WriteLine();  
                Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);  
                Console.WriteLine("Current value: " + kvp.Value.PropertyList["PropertyName"]);  

                // Change value using the newMIFSize value passed in.   
                embeddedProperties["Maximum 3rd Party MIF Size"]["Value"].StringValue = newMIFSize;  
                Console.WriteLine("New value    : " + newMIFSize);  
            }  

            // Setting: MIF Collection  
            if (kvp.Value.PropertyList["PropertyName"] == "MIF Collection")  
            {  
                Console.WriteLine();  
                Console.WriteLine(kvp.Value.PropertyList["PropertyName"]);  
                Console.WriteLine("Current value: " + kvp.Value.PropertyList["PropertyName"]);  

                // Change value using the newMIFCollection value passed in.   
                embeddedProperties["MIF Collection"]["Value"].StringValue = newMIFCollection;  
                Console.WriteLine("New value    : " + newMIFCollection);  
            }  

            // Store the settings that have changed.  
            siteDefinition.EmbeddedProperties = embeddedProperties;  
        }  

        // Save the settings.   
        siteDefinition.Put();  

    }  

    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed. Error: " + ex.InnerException.Message);  
        throw;  
    }  

}

Die Beispielmethode verfügt über die folgenden Parameter:

Parameter Typ Beschreibung
- connection
- swbemServices		 -Verwalteten: WqlConnectionManager
– VBScript: SWbemServices		 Eine gültige Verbindung mit dem SMS-Anbieter.
swbemContext -Vbscript: SWbemContext Ein gültiges Kontextobjekt. Weitere Informationen finden Sie unter Hinzufügen eines Configuration Manager Kontextqualifizierers mithilfe von WMI.
siteCode -Verwalteten: String
-Vbscript: String		 Der Standortcode.
enableDisableClientAgent -Verwalteten: String
-Vbscript: String		 Ein Wert zum Aktivieren oder Deaktivieren des Client-Agents.

Deaktiviert – 0

Aktiviert – 1
newInventorySchedule -Verwalteten: String
-Vbscript: String		 Ein Wert zum Festlegen des Inventurzeitplans.
newMIFSize -Verwalteten: String
-Vbscript: String		 Ein -Wert zum Festlegen der maximalen Größe des Hardwareinventur-MIF.

Der Standardwert ist 512.
newMIFCollection -Verwalteten: String
-Vbscript: String		 Ein Wert zum Aktivieren oder Deaktivieren der MIF-Sammlung.

Sammeln:

Keine Dateien (MIF) – 0

NOIDMIF-Dateien – 4

IDMIF-Dateien – 8

Sowohl NOIDMIF- als auch IDMIF-Dateien – 12

Kompilieren des Codes

Für dieses C#-Beispiel ist Folgendes erforderlich:

Namespaces

System

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

.NET Framework-Sicherheit

Weitere Informationen zum Schützen Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.

Siehe auch

Informationen zu Configuration Manager Inventory
Informationen zur Configuration Manager-Websitesteuerungsdatei
Lesen und Schreiben in die Configuration Manager-Websitesteuerungsdatei mithilfe von verwaltetem Code
Lesen und Schreiben in die Configuration Manager Site Control-Datei mithilfe von WMI
WMI-Klasse des SMS_SCI_Component-Servers
Informationen zu ZeitplänenCreate eines Zeitplantokens