Configuration Managerでコレクション変数を作成する方法

2025-06-06

Configuration Manager コレクションのコレクション変数を作成するには、SMS_CollectionVariable Server WMI クラスのインスタンスSMS_CollectionSettingsサーバー WMI クラスのCollectionVariables プロパティに追加します。

コレクション変数を作成するには

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」を参照してください。

次の方法で共有