オペレーティング システム展開タスク シーケンス グループを作成する方法

Configuration Manager、オペレーティング システム展開タスク シーケンス グループは、SMS_TaskSequence_Group クラスのインスタンスを作成することによってタスク シーケンスに追加できます。 グループは、タスク シーケンスの手順の一覧に追加されます。 ステップのリストは、 SMS_TaskSequence_Step 派生クラスの配列です。 配列は、タスク シーケンス、 SMS_TaskSequenceSteps プロパティに格納されます。

タスク シーケンス グループを作成するには

  1. SMS プロバイダーへの接続をセットアップします。 詳細については、「 SMS プロバイダーの基礎」を参照してください。

  2. 有効なタスク シーケンス (SMS_TaskSequence) オブジェクトを取得します。 詳細については、「 オペレーティング システム展開タスク シーケンスを作成する方法」を参照してください。

  3. SMS_TaskSequence_Group クラスのインスタンスを作成します。

  4. グループに適切なプロパティを設定します。

  5. 新しいグループでタスク シーケンス Steps プロパティを更新します。

次の例では、指定されたタスク シーケンスに新しいグループを追加します。 グループはタスク シーケンス Steps 配列の末尾に追加されるため、その位置を並べ替えることもできます。 詳細については、「 オペレーティング システム展開タスク シーケンスを並べ替える方法」を参照してください。

サンプル コードの呼び出しの詳細については、「Configuration Manager コード スニペットの呼び出し」を参照してください。

Sub AddTaskSequenceGroup(connection, taskSequence, name, description)

    Dim group

    ' Create and populate the group.
    Set group = connection.Get("SMS_TaskSequence_Group").SpawnInstance_
    group.Name=name
    group.Description=description
    group.Enabled=True
    group.ContinueOnError=False

    ' Resize the task sequence steps array to hold the new group.
    ReDim steps (UBound (taskSequence.Steps)+1)

    ' Add the group.
    taskSequence.Steps(UBound(steps))=group

End Sub
public IResultObject AddTaskSequenceGroup(
    WqlConnectionManager connection,
    IResultObject taskSequence,
    string name,
    string description)
{
    try
    {
        // Create the new group.
        IResultObject ro = connection.CreateEmbeddedObjectInstance("SMS_TaskSequence_Group");

        ro["Name"].StringValue = name;
        ro["Description"].StringValue = description;
        ro["Enabled"].BooleanValue = true;
        ro["ContinueOnError"].BooleanValue = false;

        // Add the group to the task sequence.
        List<IResultObject> array = taskSequence.GetArrayItems("Steps");
        array.Add(ro);

        // Add the new group to the end of the current steps.
        taskSequence.SetArrayItems("Steps", array);

        return ro;
    }
    catch (SmsException e)
    {
        Console.WriteLine("Failed to create Task Sequence: " + e.Message);
        throw;
    }
}

この例のメソッドには、次のパラメータがあります:

パラメーター 説明
connection - 管理対象: WqlConnectionManager
- VBScript: SWbemServices
SMS プロバイダーへの有効な接続。
taskSequence - 管理対象: IResultObject
- VBScript: SWbemObject
有効なタスク シーケンス (SMS_TaskSequence)。 グループがこのタスク シーケンスに追加されます。
Name - 管理対象: String
- VBScript: String
新しいグループの名前。
Description - 管理対象: String
- VBScript: String
新しいグループの説明。
パラメーター 説明
connection SMS プロバイダーへの有効な接続である WqlConnectionManager オブジェクト。
taskSequence 有効なタスク シーケンス (SMS_TaskSequence) であるIResultObject。 グループがこのタスク シーケンスに追加されます。
name 新しいグループの文字列名。
description 新しいグループの文字列の説明。

堅牢なプログラミング

エラー処理の詳細については、「Configuration Manager のエラーについて」を参照してください。

.NET Framework のセキュリティ

Configuration Manager アプリケーションのセキュリティ保護の詳細については、「Configuration Manager ロールベースの管理」を参照してください。

関連項目

オブジェクトの概要オペレーティング システム展開グループに手順を追加する方法マネージド コードを使用して Configuration Manager で SMS プロバイダーに接続する方法WMI を使用して Configuration Manager で SMS プロバイダーに接続する方法オペレーティング システム展開タスク シーケンスを作成する方法 タスク シーケンスの概要