Taakreeksvariabelen gebruiken in een actieve Configuration Manager taakreeks

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

Gewoonlijk gebruikt u een opdrachtregelactie waarmee een script wordt uitgevoerd om toegang te krijgen tot de variabelen van de takenreeks. U kunt ze echter ook openen in een actieve takenreeks door een programmeeromgeving te gebruiken waarin COM-automatiseringsobjecten kunnen worden gebruikt.

Als u een aangepaste taakreeksvariabele wilt maken, stelt u een Microsoft.SMS.TSEnvironment eigenschap in door de naam te gebruiken 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 bijgewerkt. U kunt de aangepaste variabele waarde later ophalen van Microsoft.SMS.TSEnvironment.

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

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

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

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

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

Het wordt afgeraden om beheerde code te gebruiken met de omgeving voor taakvolgorde, 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.

  Welke versie van .NET Framework vereist is, is afhankelijk van de versie van Visual Studio die u gebruikt.

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

• Verwijzing naar TSEnvironment 1.0 Type Library.

• De TSEnvironmentLib-naamruimte .

Taakvariabelen gebruiken in een actieve takenreeks

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

2. De vereiste omgevingsvariabele ophalen of instellen.

Voorbeeld

De volgende voorbeeldmethode haalt de _SMSTSLogPath variabele op. Ook wordt de waarde van een aangepaste variabele en de waarde van een aangepaste matrixvariabele ingesteld.

Zie Codefragmenten van Configuration Manager aanroepen 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

Omgeving voor taakvolgorde bij implementatie van besturingssysteem

Robuust programmeren

Zie Info over fouten in Configuration Manager voor meer informatie over foutafhandeling.

.NET Framework-beveiliging

Zie Rolgebaseerd beheer van Configuration Manager voor meer informatie over het beveiligen van Configuration Manager-toepassingen.

Zie ook

Overzicht van objectenVerbinding maken met een sms-aanbieder in Configuration Manager met behulp van beheerde codeVerbinding maken met een sms-aanbieder in Configuration Manager met behulp van WMIOverzicht van takenreeksEen taakreeksvariabele instellen voor de implementatie van een besturingssysteem