Delen via

Takenreeksvariabelen gebruiken in een actieve Configuration Manager takenreeks

  • Artikel

In Configuration Manager kunt u takenreeksvariabelen maken, ophalen en instellen in een actieve takenreeks met behulp van het COM-automatiseringsobject () van de takenreeksomgeving.Microsoft.SMS.TSEnvironment

Normaal gesproken gebruikt u een opdrachtregelactie waarmee een script wordt uitgevoerd voor toegang tot de takenreeksvariabelen. Maar u kunt ze ook openen, binnen een takenreeks uitvoeren, met behulp van elke programmeeromgeving die COM-automatiseringsobjecten kan gebruiken.

Opmerking

Wanneer u een taakvariabele instelt op de Configuration Manager-client, wordt deze beschikbaar voor de volgende stappen in de takenreeks.

Als u een aangepaste takenreeksvariabele wilt maken, stelt u een Microsoft.SMS.TSEnvironment eigenschap in met behulp van de naam van de nieuwe variabele die u wilt maken. Als de variabele nog niet bestaat, wordt deze gemaakt. Als de variabele al bestaat, wordt de waarde ervan bijgewerkt. U kunt de waarde van de aangepaste variabele later ophalen uit Microsoft.SMS.TSEnvironment.

Wanneer een takenreeksvariabele een matrix is, wordt deze doorgegeven in de volgende indeling:

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

De variabele is bijvoorbeeld OSDPartitions een matrix van SMS_TaskSequencePartitionSettings. Het volgende voorbeeld vertegenwoordigt een matrix met één element OSDPartitions :

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

Voor toegang tot FileSystem deze matrix gebruikt OSDPartitions0FileSystemu . Als de matrix groter is, gebruiktOSDPartitions1FileSystem u voor het tweede element, enzovoort via de matrix.

Het wordt afgeraden beheerde code te gebruiken met de taakvolgordeomgeving, omdat u deze niet kunt gebruiken in de volgende omgevingen:

  • Windows PE

  • Windows Server 2008

  • Windows 2000

    Beheerde code werkt wel wanneer het volledige besturingssysteem wordt uitgevoerd met de juiste versie van .NET Framework geïnstalleerd.

    De vereiste versie van .NET Framework is afhankelijk van de versie van Visual Studio die u gebruikt.

Visual Studio .NET Framework versie
Visual Studio 2003 1.0
Visual Studio 2005 2.0
Visual Studio 2008 2,0 tot 3,5

U moet COM-interoperabiliteit gebruiken om toegang te krijgen tot het TSEnvironment object. U hebt het volgende nodig:

  • Verwijzing naar TSEnvironment 1.0 Type Library.

  • De naamruimte TSEnvironmentLib .

Taakvariabelen gebruiken in een actieve takenreeks

  1. Maak in een actieve takenreeks een exemplaar van Microsoft.SMS.TSEnvironment.

  2. Haal de vereiste omgevingsvariabele op of stel deze in.

Voorbeeld

Met de volgende voorbeeldmethode wordt de _SMSTSLogPath variabele ophaalt. Ook wordt de waarde van een aangepaste variabele en een aangepaste variabelewaarde voor een matrix ingesteld.

Zie Aanroepen Configuration Manager codefragmenten voor meer informatie over het aanroepen van de voorbeeldcode.

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

De code compileren

Platforms

Sequentieringsomgeving voor besturingssysteemimplementatietaken

Robuust programmeren

Zie Over Configuration Manager fouten voor meer informatie over foutafhandeling.

.NET Framework Beveiliging

Zie Configuration Manager op rollen gebaseerd beheer voor meer informatie over het beveiligen van Configuration Manager toepassingen.

Zie ook

Overzicht van objectenVerbinding maken met een SMS-provider in Configuration Manager met behulp van beheerde code
Verbinding maken met een SMS-provider in Configuration Manager met behulp van WMI
TakenreeksoverzichtEen takenreeksvariabele voor besturingssysteemimplementatie instellen