如何指定驅動程式支援的平臺

文章
04/04/2023

在Configuration Manager中，您會在驅動程式的 SMS_Driver Server WMI Class物件的屬性 XML 中 SDMPackageXML 指定驅動程式支援的平臺。 XML 包含一個節點 PlatformApplicabilityConditions ，可讓您為驅動程式支援的每個平臺新增 PlatformApplicabilityCondition 元素。

注意事項

您應該只新增列在 SMS_SupportedPlatforms Server WMI Class 物件中的平臺。驅動程式只能針對主要作業系統版本設定條件，也就是說，無法以 Service Pack 的驅動程式為目標。

注意

支援的平臺部分 SDMPackageXML 是 CI-XML 架構中唯一可以編輯的部分。您不應該對 XML 的其他部分進行變更。

下列 XML 示範支援兩個平臺的驅動程式。如需支援平臺架構的詳細資訊，請參閱作業系統部署驅動程式支援的平臺架構。

<PlatformApplicabilityConditions>  
    <PlatformApplicabilityCondition DisplayName="All x64 Windows XP Professional" MaxVersion="5.20.9999.9999" MinVersion="5.20.3790.0" Name="Win NT" Platform="x64">  
        <Query1>SELECT * FROM Win32_OperatingSystem WHERE BuildNumber = '3790' AND OSType=18 AND ProductType=1</Query1>   
        <Query2>SELECT * FROM Win32_Processor WHERE Architecture=9 AND DataWidth=64</Query2>   
        </PlatformApplicabilityCondition>  
    <PlatformApplicabilityCondition DisplayName="All x86 Windows 2000" MaxVersion="5.00.9999.9999" MinVersion="5.00.0000.0" Name="Win NT" Platform="I386">  
        <Query1>SELECT * FROM Win32_OperatingSystem WHERE BuildNumber = '2195' AND OSType=18 AND ServicePackMajorVersion >= 4</Query1>   
        <Query2>SELECT * FROM Win32_Processor WHERE Architecture=0</Query2>   
    </PlatformApplicabilityCondition>  
</PlatformApplicabilityConditions>

若要驗證平臺適用性需求，請使用SMS_SupportedPlatforms必要平臺的伺服器 WMI 類別類別 Condition 屬性。

指定驅動程式支援的平臺

設定與 SMS 提供者的連線。如需詳細資訊，請參閱 SMS 提供者基本概念。
取得驅動程式的SMS_Driver伺服器 WMI 類別物件。驅動程式是由索引鍵屬性 CI_ID 識別。如需使用索引鍵屬性取得物件的相關資訊，請參閱如何使用 Managed 程式碼讀取Configuration Manager物件
更新驅動程式 XML。
將變更認可回 SMS 提供者。

範例

下列範例方法會將支援的平臺新增至所識別的驅動程式 objDriver 。例如，下列呼叫程式碼會將 Windows XP Professional x64 作業系統新增至支援的平臺驅動程式 objDriver 清單。您可以從特定平臺的物件實例取得其 SMS_SupportedPlatforms 詳細資料。

AddSupportedPlatform objDriver, "All x64 Windows XP Professional", "5.20.9999.9999","5.20.3790.0", "Win NT","x64", "SELECT * FROM Win32_OperatingSystem WHERE BuildNumber = 3790 AND OSType=18 AND ProductType=1", "SELECT * FROM Win32_Processor WHERE Architecture=9 AND DataWidth=64"

如需呼叫範例程式碼的相關資訊，請參閱呼叫Configuration Manager程式碼片段。

Sub AddSupportedPlatform( objDriver, sDisplayName, sMaxVersion, sMinVersion, sName, sPlatform, sQuery1, sQuery2 )  

    Dim xmlDoc  
    Dim objPlatformNode  
    Dim objAttr  
    Dim objQuery1Node  
    Dim objQuery2Node  
    Dim objPlatformsNode  
    Dim objDriverNode  

    ' Load the SDM Package XML.  
    Set xmlDoc = CreateObject("Msxml2.DOMDocument.6.0")  

    xmlDoc.async = False  
    xmlDoc.loadXML(objDriver.Properties_.item("SDMPackageXML"))  
    xmlDoc.setProperty _  
     "SelectionNamespaces","xmlns:dcm='http://schemas.microsoft.com/SystemsCenterConfigurationManager/2006/03/24/DesiredConfiguration'"  

    ' Create a new platform node.  
    Set objPlatformNode = xmlDoc.createNode _  
    ( 1, "PlatformApplicabilityCondition", _  
     "http://schemas.microsoft.com/SystemsCenterConfigurationManager/2006/03/24/DesiredConfiguration")  

    ' Set DisplayName.  
    Set objAttr = xmlDoc.createAttribute("DisplayName")  
    objAttr.value = sDisplayName  
    objPlatformNode.setAttributeNode(objAttr)  

    ' Set MaxVersion.  
    Set objAttr = xmlDoc.createAttribute("MaxVersion")  
    objAttr.value = sMaxVersion  
    objPlatformNode.setAttributeNode(objAttr)  

    ' Set MinVersion.  
    Set objAttr = xmlDoc.createAttribute("MinVersion")  
    objAttr.value = sMinVersion  
    objPlatformNode.setAttributeNode(objAttr)  

    ' Set Name.  
    Set objAttr = xmlDoc.createAttribute("Name")  
    objAttr.value = sName  
    objPlatformNode.setAttributeNode(objAttr)  

    ' Set Platform.  
    Set objAttr = xmlDoc.createAttribute("Platform")  
    objAttr.value = sPlatform  
    objPlatformNode.setAttributeNode(objAttr)  

    ' Set Query1.  
    Set objQuery1Node = xmlDoc.createNode(1, "Query1", "http://schemas.microsoft.com/SystemsCenterConfigurationManager/2006/03/24/DesiredConfiguration")  
    objQuery1Node.text = sQuery1  
    objPlatformNode.appendChild(objQuery1Node)  

    ' Set Query2.  
    Set objQuery2Node = xmlDoc.createNode(1, "Query2", "http://schemas.microsoft.com/SystemsCenterConfigurationManager/2006/03/24/DesiredConfiguration")  
    objQuery2Node.text = sQuery2  
    objPlatformNode.appendChild(objQuery2Node)  

    ' Append to platforms node.  
    Set objPlatformsNode = xmlDoc.selectSingleNode("/dcm:DesiredConfigurationDigest/dcm:Driver/dcm:PlatformApplicabilityConditions")      
    objPlatformsNode.appendChild(objPlatformNode)  

    ' Increment the version number.  
    Set objDriverNode = xmlDoc.selectSingleNode("/dcm:DesiredConfigurationDigest/dcm:Driver")  
    Set objAttr = objDriverNode.attributes.getNamedItem("Version")  
    objAttr.value = objAttr.value + 1  

    ' Save the object.  
    objDriver.Properties_.item("SDMPackageXML") = xmlDoc.xml  
    objDriver.Put_  

End Sub

public void AddSupportedPlatform(  
    IResultObject driver,  
    string displayName,  
    string maxVersion,  
    string minVersion,  
    string name,  
    string platform,  
    string query1,  
    string query2)  
{  
    try  
    {  
        XmlDocument xmlDoc = new XmlDocument();  
        xmlDoc.LoadXml(driver["SDMPackageXML"].StringValue);  

        string dcmXmlNamespace = "http://schemas.microsoft.com/SystemsCenterConfigurationManager/2006/03/24/DesiredConfiguration";  
        XmlNode condition = xmlDoc.CreateNode  
         (XmlNodeType.Element, "PlatformApplicabilityCondition", dcmXmlNamespace);  

        XmlAttribute displayNameAttribute = xmlDoc.CreateAttribute("DisplayName");  
        displayNameAttribute.Value = displayName;  
        condition.Attributes.SetNamedItem(displayNameAttribute);  

        XmlAttribute osMaxVersionAttribute = xmlDoc.CreateAttribute("MaxVersion");  
        osMaxVersionAttribute.Value = maxVersion;  
        condition.Attributes.SetNamedItem(osMaxVersionAttribute);  

        XmlAttribute osMinVersionAttribute = xmlDoc.CreateAttribute("MinVersion");  
        osMinVersionAttribute.Value = minVersion;  
        condition.Attributes.SetNamedItem(osMinVersionAttribute);  

        XmlAttribute osNameAttribute = xmlDoc.CreateAttribute("Name");  
        osNameAttribute.Value = name;  
        condition.Attributes.SetNamedItem(osNameAttribute);  

        XmlAttribute osPlatformAttribute = xmlDoc.CreateAttribute("Platform");  
        osPlatformAttribute.Value = platform;  
        condition.Attributes.SetNamedItem(osPlatformAttribute);  

        // Create <Query1/> and <Query2/> child nodes.  
        // Then attach to <PlatformApplicabilityCondition/>.  
        XmlNode query1Node = xmlDoc.CreateNode  
            (XmlNodeType.Element, "Query1", dcmXmlNamespace);  
        query1Node.InnerText = query1;  
        condition.AppendChild(query1Node);  

        XmlNode query2Node = xmlDoc.CreateNode  
            (XmlNodeType.Element, "Query2", dcmXmlNamespace);  
        query2Node.InnerText = query2;  
        condition.AppendChild(query2Node);  

        XmlNode platformsNode = xmlDoc["DesiredConfigurationDigest"]["Driver"]["PlatformApplicabilityConditions"];  

         if (platformsNode == null)  
        {  
            Console.WriteLine("empty");  
        }  

        platformsNode.AppendChild(condition);  

        XmlNode driverNode = xmlDoc["DesiredConfigurationDigest"]["Driver"];  
        if (driverNode != null)  
        {  
            int driverVersion = int.Parse(driverNode.Attributes.GetNamedItem("Version").Value) + 1;  
            driverNode.Attributes.GetNamedItem("Version").Value = (driverVersion + 1).ToString();  
        }  
        else  
        {  
            throw new XmlException("Unable to find <Driver/> node while AddingSupportedPlatforms");  
        }  

        // Add the package XML to the driver.  
        StringBuilder xmlText = new StringBuilder();  
        xmlDoc.WriteContentTo(new XmlTextWriter(new StringWriter(xmlText)));  
        driver["SDMPackageXML"].StringValue = xmlText.ToString();  

       driver.Put();  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("failed to add supported platform to driver " + e.Message);  
        throw;  
    }  
}

範例方法具有下列參數：

參數	Type	描述
`driver` `objDriver`	-管理： `IResultObject` - VBScript： SWbemObject	- 有效的 SMS_Driver 物件。如需詳細資訊，請參閱如何將 INF 檔案所描述的 Windows 驅動程式匯入Configuration Manager。
`displayName` `sDisplayName`	-管理： `String` - VBScript： `String`	Configuration Manager主控台中顯示之條件的顯示名稱。
`maxVersion` `sMaxVersion`	-管理： `String` - VBScript： `String`	支援的最大版本。
`minVersion` `sMinVersion`	-管理： `String` - VBScript： `String`	支援的最低版本。
`name` `sName`	-管理： `String` - VBScript： `String`	作業系統名稱。
`platform` `sPlatform`	-管理： `String` - VBScript： `String`	平臺名稱。
`query1` `sQuery1`	-管理： `String` - VBScript： `String`	用來識別用戶端平臺的第一個查詢。
`query2` `sQuery2`	-管理： `String` - VBScript： `String`	用來識別用戶端平臺的第二個查詢。

正在編譯程式碼

此 C# 範例需要：

命名空間

系統

System.Collections.Generic

System.Text

Microsoft。ConfigurationManagement.ManagementProvider

Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine

System.Xml

System.IO

組件

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

健全的程式設計

如需錯誤處理的詳細資訊，請參閱關於Configuration Manager錯誤。

.NET Framework 安全性

如需保護Configuration Manager應用程式的詳細資訊，請參閱Configuration Manager角色型系統管理。

另請參閱

SMS_SupportedPlatforms伺服器 WMI 類別
 物件概觀如何使用 Managed 程式碼在Configuration Manager中連線至 SMS 提供者
 如何使用 WMI 在 Configuration Manager 中連線到 SMS 提供者
 如何將步驟移至不同的作業系統部署工作順序群組
 如何建立作業系統部署工作順序群組
 如何從作業系統部署群組移除步驟
 伺服器 WMI 類別SMS_SupportedPlatforms 工作順序概觀

分享方式：