Freigeben über


Aktivieren einer PXE-Dienstpunktrolle

Sie aktivieren die PXE-Dienstpunktrolle in Configuration Manager, indem Sie eine Instanz eines bestimmten Verteilungspunkts abrufen und den IsPXE Wert auf 1festlegen.

So aktivieren Sie eine PXE-Dienstpunktrolle

  1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.

  2. Ruft eine Instanz eines bestimmten Verteilungspunkts ab.

  3. Legen Sie die IsPXE eingebettete Eigenschaft auf fest 1.

  4. Speichern Sie die Verteilungspunktinstanz.

Beispiel

Die folgende Beispielmethode aktiviert einen PXE-Dienstpunkt.

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

public void EnablePXE(WqlConnectionManager connection,                      string siteCode,                      string serverName){    try    {        //Connect to distribution point instance.                        IResultObject siteRole = connection.GetInstance("SMS_SCI_SysResUse.FileType=2,ItemName=\"[\\\"Display=\\\\\\\\" + serverName + "\\\\\\\"]MSWNET:[\\\"SMS_SITE=" + siteCode + "\\\"]\\\\\\\\" + serverName + "\\\\,SMS Distribution Point\",ItemType=\"System Resource Usage\",SiteCode=" + "\"" + siteCode + "\"");        // Create temporary copy of the embedded properties.        Dictionary<string, IResultObject> embeddedProperties = siteRole.EmbeddedProperties;        // Enumerate through the embedded properties and makes changes as needed.        foreach (KeyValuePair<string, IResultObject> kvp in siteRole.EmbeddedProperties)        {            // Setting: IsPXE            if (kvp.Value.PropertyList["PropertyName"] == "IsPXE")            {                // Get current property value.                Console.WriteLine();                Console.WriteLine("Property: {0}", kvp.Value.PropertyList["PropertyName"]);                Console.WriteLine("Current value: {0} (0 not enabled, 1 enabled)", kvp.Value.PropertyList["Value"]);                // Change value to enable PXE (1 enabled, 0 not enabled).                 embeddedProperties["IsPXE"]["Value"].StringValue = "1";                Console.WriteLine("Setting the {0} value to {1}.", kvp.Value.PropertyList["PropertyName"], "1");            }        }        // Store the settings that have changed.        siteRole.EmbeddedProperties = embeddedProperties;        // Save the settings.         siteRole.Put();    }    catch (SmsException ex)    {        Console.WriteLine();        Console.WriteLine("Failed. Error: " + ex.InnerException.Message);    }}   

Die Beispielmethode verfügt über die folgenden Parameter:

Parameter Typ Beschreibung
connection Verwalteten: WqlConnectionManager Eine gültige Verbindung mit dem SMS-Anbieter.
siteCode Verwalteten: String Der Configuration Manager-Standortcode.
serverName Verwalteten: String Der Servername. Beispiel: "SERVER1.DOMAIN1.COM"

Kompilieren des Codes

Das C#-Beispiel hat die folgenden Kompilierungsanforderungen:

Namespaces

System

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

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

WMI-Klasse des SMS_SCI_SysResUse-Servers
PackNALPath-Methode in Class SMS_NAL_Methods
Informationen zur Konfiguration der Standortrollen für die BetriebssystembereitstellungFestlegen der Antwortverzögerung für einen PXE-Dienstpunkt
Festlegen der PXE-Dienstpunktantwort auf alle Netzwerkschnittstellen
Festlegen der PXE-Dienstpunktantwort auf PXE-Anforderungen
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