Verwenden von Tasksequenzvariablen in einer ausgeführten Tasksequenz des Configuration Manager

In Configuration Manager können Sie Tasksequenzvariablen in einer laufenden Tasksequenz erstellen, abrufen und festlegen, indem Sie das COM-Automatisierungsobjekt ()Microsoft.SMS.TSEnvironment der Tasksequenzumgebung verwenden.

In der Regel verwenden Sie eine Befehlszeilenaktion, die ein Skript ausführt, um auf die Tasksequenzvariablen zuzugreifen. Sie können aber auch innerhalb einer ausgeführten Tasksequenz auf sie zugreifen, indem Sie eine beliebige Programmierumgebung verwenden, die COM-Automatisierungsobjekte verwenden kann.

Zum Erstellen einer benutzerdefinierten Tasksequenzvariablen legen Sie eine Microsoft.SMS.TSEnvironment Eigenschaft mit dem Namen der neuen Variablen fest, die Sie erstellen möchten. Wenn die Variable noch nicht vorhanden ist, wird sie erstellt. Falls die Variable bereits existiert, wird ihr Wert aktualisiert. Sie können den Wert der benutzerdefinierten Variablen später aus Microsoft.SMS.TSEnvironmentabrufen.

Wenn eine Tasksequenzvariable ein Array ist, wird sie im folgenden Format übergeben:

<base array name><element #><Property>="value".

Die OSDPartitions Variable ist beispielsweise ein Array von SMS_TaskSequencePartitionSettings. Das folgende Beispiel stellt ein Array mit einem Element OSDPartitions dar:

OSDPartitions0Bootable="true"
OSDPartitions0FileSystem="NTFS"
OSDPartition0QuickFormat="false"
OSDPartitions0Size="100"
OSDPartitions0SizeUnits="Percent"
OSDPartitions0Type="Primary"

Für den Zugriff FileSystem in diesem Array würden OSDPartitions0FileSystemSie verwenden. Wenn das Array größer ist, verwendenOSDPartitions1FileSystem Sie es für das zweite Element und so weiter durch das Array.

Es wird nicht empfohlen, verwalteten Code mit der Tasksequenzumgebung zu verwenden, da er in den folgenden Umgebungen nicht verwendet werden kann:

• Windows PE

• Windows Server 2008

• Windows 2000

  Verwalteter Code funktioniert, wenn das vollständige Betriebssystem ausgeführt und die richtige Version von .NET Framework installiert ist.

  Welche Version von .NET Framework erforderlich ist, hängt von der verwendeten Version von Visual Studio ab.

Sie müssen COM-Interop verwenden, um auf das TSEnvironment Objekt zuzugreifen. Sie benötigen Folgendes:

• Verweis auf die TSEnvironment 1.0-Typbibliothek.

• Der TSEnvironmentLib-Namespace .

So verwenden Sie Taskvariablen in einer ausgeführten Tasksequenz

1. Erstellen Sie in einer ausgeführten Tasksequenz eine instance von Microsoft.SMS.TSEnvironment.

2. Rufen Sie die erforderliche Umgebungsvariable ab, oder legen Sie sie fest.

Beispiel

Die folgende Beispielmethode ruft die _SMSTSLogPath Variable ab. Außerdem wird der Wert einer benutzerdefinierten Variablen und eines benutzerdefinierten Arrayvariablenwerts festgelegt.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager-Codeausschnitten.

Sub UseTaskSequenceVariables()
   dim osd: set env = CreateObject("Microsoft.SMS.TSEnvironment")
   dim logPath

   ' You can query the environment to get an existing variable.
   logPath = env("_SMSTSLogPath")

    wscript.echo logPath

   ' You can also set a variable in the Operating System Deployment environment.
   env("MyCustomVariable") = "My Custom Value"

   ' Set the OSDPartitions(0) Bootable array member to 0.
    env("OSDPartitions0Bootable") = "true"
End Sub

Kompilieren des Codes

Plattformen

Umgebung für die Sequenzierung von Aufgaben bei der Betriebssystembereitstellung

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager-Fehlern.

.NET Framework-Sicherheit

Weitere Informationen zum Sichern von Configuration Manager-Anwendungen finden Sie unter rollenbasierte Verwaltung von Configuration Manager.

Siehe auch

Objekte – ÜbersichtHerstellen einer Verbindung mit einem SMS-Anbieter in Configuration Manager mithilfe von verwaltetem CodeHerstellen einer Verbindung mit einem SMS-Anbieter im Configuration Manager mithilfe von WMIÜbersicht über die TasksequenzFestlegen einer Tasksequenzvariable für die Betriebssystembereitstellung