Jak używać zmiennych sekwencji zadań w uruchomionej sekwencji zadań programu Configuration Manager

W programie Configuration Manager można tworzyć, pobierać i ustawiać zmienne sekwencji zadań w uruchomionej sekwencji zadań przy użyciu obiektu automatyzacji COM środowiska sekwencji zadań (Microsoft.SMS.TSEnvironment).

Zazwyczaj używana jest akcja wiersza polecenia, która uruchamia skrypt w celu uzyskania dostępu do zmiennych sekwencji zadań. Ale można również uzyskać do nich dostęp, w ramach uruchomionej sekwencji zadań, przy użyciu dowolnego środowiska programistycznego, które może korzystać z obiektów automatyzacji COM.

Uwaga

Po ustawieniu zmiennej zadania na kliencie programu Configuration Manager staje się ona dostępna dla kolejnych kroków w sekwencji zadań.

Aby utworzyć niestandardową zmienną sekwencji zadań, należy ustawić właściwość Microsoft.SMS.TSEnvironment przy użyciu nazwy nowej zmiennej, która ma zostać utworzona. Jeśli zmienna jeszcze nie istnieje, zostanie utworzona. Jeśli zmienna już istnieje, aktualizowana jest jej wartość. Wartość zmiennej niestandardowej można później pobrać z Microsoft.SMS.TSEnvironment.

Gdy zmienna sekwencji zadań jest tablicą, jest przekazywana w następującym formacie:

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

Zmienna OSDPartitions jest na przykład tablicą SMS_TaskSequencePartitionSettings. Poniższy przykład reprezentuje tablicę jednoelementową OSDPartitions :

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

Aby uzyskać dostęp FileSystem w tej tablicy, należy użyć OSDPartitions0FileSystem. Jeśli tablica jest większa, należy użyćOSDPartitions1FileSystem dla drugiego elementu i tak dalej za pośrednictwem tablicy.

Nie zaleca się używania kodu zarządzanego w środowisku sekwencjonowania zadań, ponieważ nie można go używać w następujących środowiskach:

  • Windows PE

  • Windows Server 2008

  • Windows 2000

    Kod zarządzany działa, gdy jest uruchomiony pełny system operacyjny z zainstalowaną odpowiednią wersją platformy .NET Framework.

    Wymagana wersja programu .NET Framework zależy od używanej wersji programu Visual Studio.

Visual Studio Wersja programu .NET Framework
Visual Studio 2003 1.0
Visual Studio 2005 2.0
Visual Studio 2008 Od 2,0 do 3,5

Aby uzyskać dostęp TSEnvironment do obiektu, należy użyć współdziałania COM. Potrzebne będą:

  • Odniesienie do biblioteki typów TSEnvironment 1.0.

  • Przestrzeń nazw TSEnvironmentLib .

Aby użyć zmiennych zadań w uruchomionej sekwencji zadań

  1. W uruchomionej sekwencji zadań utwórz wystąpienie .Microsoft.SMS.TSEnvironment

  2. Pobierz lub ustaw wymaganą zmienną środowiskową.

Przykład

Poniższa przykładowa metoda pobiera _SMSTSLogPath zmienną. Ustawia również wartość zmiennej niestandardowej i wartość zmiennej niestandardowej tablicy.

Aby uzyskać informacje na temat wywoływania przykładowego kodu, zobacz Wywoływanie fragmentów kodu programu Configuration Manager.

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

Kompilowanie kodu

Platformy

Środowisko sekwencjonowania zadań wdrażania systemu operacyjnego

Wydajne programowanie

Aby uzyskać więcej informacji na temat obsługi błędów, zobacz Informacje o błędach programu Configuration Manager.

Zabezpieczenia platformy .NET Framework

Aby uzyskać więcej informacji na temat zabezpieczania aplikacji programu Configuration Manager, zobacz Administracja oparta na rolach programu Configuration Manager.

Zobacz też

Omówienie obiektówJak nawiązać połączenie z dostawcą wiadomości SMS w programie Configuration Manager przy użyciu kodu zarządzanegoJak połączyć się z dostawcą wiadomości SMS w programie Configuration Manager przy użyciu usługi WMIOmówienie sekwencji zadańJak ustawić zmienną sekwencji zadań wdrażania systemu operacyjnego