如何在 Configuration Manager 中创建集合变量

项目
04/04/2023

通过将 SMS_CollectionVariable 服务器 WMI 类的实例添加到 SMS_CollectionSettings 服务器 WMI 类CollectionVariables的属性，为 Configuration Manager 集合创建集合变量。

创建集合变量

设置与 SMS 提供程序的连接。有关详细信息，请参阅 SMS 提供程序基础知识。
获取 SMS_CollectionSettings 的实例。
对于要添加的每个变量，请将嵌入对象的实例 SMS_CollectionVariable 添加到 CollectionVariables 数组属性。
将更改提交到 SMS_CollectionSettings 类实例。

示例

以下示例方法创建一个集合变量，并将其添加到由提供的标识符标识的集合中。 SMS_CollectionSettings如果集合的对象不存在，则会创建它。

有关调用示例代码的信息，请参阅调用Configuration Manager代码片段。

Sub CreateCollectionVariable( connection, name, value, mask, collectionId, precedence)  

    Dim collectionSettings  
    Dim collectionVariables  
    Dim collectionVariable  
    Dim Settings  

    ' See if the settings collection already exists. if it does not, create it.  
    Set settings = connection.ExecQuery _  
      ("Select * From SMS_CollectionSettings Where CollectionID = '" & collectionID & "'")  

    If settings.Count = 0 Then  
        Wscript.Echo "Creating collection settings object"  
        Set collectionSettings = connection.Get("SMS_CollectionSettings").SpawnInstance_  
        collectionSettings.CollectionID = collectionId  
        collectionSettings.Put_  
    End If    

    ' Get the collection settings object.  
    Set collectionSettings = connection.Get("SMS_CollectionSettings.CollectionID='" & collectionId &"'" )  

    ' Get the collection variables.  
    collectionVariables=collectionSettings.CollectionVariables  

    ' Create and populate a new collection variable.  
    Set collectionVariable = connection.Get("SMS_CollectionVariable").SpawnInstance_  
    collectionVariable.Name = name  
    collectionVariable.Value = value  
    collectionVariable.IsMasked = mask  

    ' Add the new collection variable.  
    ReDim Preserve collectionVariables (UBound (collectionVariables)+1)  
    Set collectionVariables(UBound(collectionVariables)) = collectionVariable  

    collectionSettings.CollectionVariables=collectionVariables  

    collectionSettings.Put_  

 End Sub

public void CreateCollectionVariable(  
    WqlConnectionManager connection,   
    string name,   
    string value,   
    bool mask,   
    string collectionId,   
    int precedence)  
{  
    try  
    {  
        IResultObject collectionSettings = null;  

        // Get the collection settings. Create it if necessary.  

         IResultObject collectionSettingsQuery = connection.QueryProcessor.ExecuteQuery(  
                    "Select * from SMS_CollectionSettings where CollectionID='" + collectionId + "'");  

         foreach (IResultObject setting in collectionSettingsQuery)  
         {  
             collectionSettings = setting;  
         }  

        if ( collectionSettings == null)  
         {  
             collectionSettings = connection.CreateInstance("SMS_CollectionSettings");  
             collectionSettings["CollectionID"].StringValue = collectionId;  
             collectionSettings.Put();  
             collectionSettings.Get();  
         }  

        // Create the collection variable.  
        List<IResultObject> collectionVariables = collectionSettings.GetArrayItems("CollectionVariables");  
        IResultObject collectionVariable = connection.CreateEmbeddedObjectInstance("SMS_CollectionVariable");  
        collectionVariable["Name"].StringValue = name;  
        collectionVariable["Value"].StringValue = value;  
        collectionVariable["IsMasked"].BooleanValue = mask;  

        // Add the collection variable to the collection settings.  
        collectionVariables.Add(collectionVariable);  
        collectionSettings.SetArrayItems("CollectionVariables", collectionVariables);  

        // Set the collection variable precedence.  
        collectionSettings["CollectionVariablePrecedence"].IntegerValue = precedence;  

        collectionSettings.Put();  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to create collection variable: " + e.Message);  
        throw;  
   }  
}

示例方法具有以下参数：

参数	类型	说明
`Connection`	-管理： `WqlConnectionManager` - VBScript： SWbemServices	与 SMS 提供程序的有效连接。
`Name`	-管理： `String` - VBScript： `String`	要创建的变量的名称。
`Value`	-管理： `String` - VBScript： `String`	变量的值
`Mask`	-管理： `Boolean` - VBScript： `Boolean`	指定是否在Configuration Manager控制台中显示值。 `true` - 不显示变量值。 `false` - 显示变量值。
`CollectionID`	-管理： `String` - VBScript： `String`	将变量添加到的集合。
`Precedence`	-管理： `Integer` - VBScript： `Integer`	变量优先于数组中的其他变量。

编译代码

C# 示例具有以下编译要求：

命名空间

System

System.Collections.Generic

Microsoft。ConfigurationManagement.ManagementProvider

Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

可靠编程

有关错误处理的详细信息，请参阅关于Configuration Manager错误。

.NET Framework 安全性

有关保护Configuration Manager应用程序的详细信息，请参阅Configuration Manager基于角色的管理。

另请参阅

对象概述如何使用托管代码连接到 Configuration Manager 中的 SMS 提供程序
 如何使用 WMI 连接到 Configuration Manager 中的短信提供程序
 如何在 Configuration Manager 中创建计算机变量
 如何使用托管代码创建Configuration Manager对象
 如何使用 WMI 创建Configuration Manager对象
 关于 OS 部署计算机管理

通过