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

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

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

  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 プロバイダーに接続する方法オペレーティング システム展開タスク シーケンスを作成する方法 タスク シーケンスの概要