Использование переменных последовательности задач в выполняемой последовательности задач Configuration Manager

Статья
04/04/2023

В Configuration Manager можно создавать, получать и задавать переменные последовательности задач в выполняющейся последовательности задач с помощью com-объекта автоматизации среды последовательности задач (Microsoft.SMS.TSEnvironment).

Как правило, для доступа к переменным последовательности задач используется действие командной строки, которое запускает скрипт. Но вы также можете получить к ним доступ в рамках выполняемой последовательности задач с помощью любой среды программирования, которая может использовать объекты автоматизации COM.

Примечание.

При задании переменной задачи в клиенте Configuration Manager она становится доступной для последующих шагов в последовательности задач.

Чтобы создать настраиваемую переменную последовательности задач, необходимо задать Microsoft.SMS.TSEnvironment свойство, используя имя новой переменной, которую требуется создать. Если переменная еще не существует, она создается. Если переменная уже существует, ее значение обновляется. Затем можно получить значение настраиваемой переменной из Microsoft.SMS.TSEnvironment.

Если переменная последовательности задач является массивом, она передается в следующем формате:

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

Например, OSDPartitions переменная является массивом SMS_TaskSequencePartitionSettings. Ниже представлен один элемент OSDPartitions Array:

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

Для доступа в FileSystem этом массиве используется OSDPartitions0FileSystem. Если массив больше, вы будете использоватьOSDPartitions1FileSystem для второго элемента и т. д. в массиве.

Не рекомендуется использовать управляемый код со средой виртуализации задач, так как его нельзя использовать в следующих средах:

Среда предустановки Windows
Windows Server 2008
Windows 2000

Управляемый код работает, когда полная операционная система работает с правильной версией платформа .NET Framework установлена.

Требуемая версия платформа .NET Framework зависит от используемой версии Visual Studio.

Visual Studio	версия платформа .NET Framework
Visual Studio 2003	1.0
Visual Studio 2005	2.0
Visual Studio 2008	с 2.0 по 3.5

Для доступа TSEnvironment к объекту потребуется использовать COM-взаимодействие. Вам потребуется следующее:

Ссылка на библиотеку типов TSEnvironment 1.0.
Пространство имен TSEnvironmentLib .

Использование переменных задачи в выполняемой последовательности задач

В выполняемой последовательности задач создайте экземпляр Microsoft.SMS.TSEnvironment.
Получите или задайте требуемую переменную среды.

Пример

В следующем примере метод получает переменную _SMSTSLogPath . Он также задает значение настраиваемой переменной и значение настраиваемой переменной массива.

Сведения о вызове примера кода см. в разделе Вызов фрагментов кода 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

Компиляция программы

Платформы

Среда виртуализации задач развертывания операционной системы

Надежное программирование

Дополнительные сведения об обработке ошибок см. в разделе Сведения об ошибках Configuration Manager.

Безопасность .NET Framework

Дополнительные сведения о защите приложений Configuration Manager см. в статье Configuration Manager администрирование на основе ролей.

См. также

Общие сведения об объектах . Подключение к поставщику SMS в Configuration Manager с помощью управляемого кода
Подключение к поставщику SMS в Configuration Manager с помощью WMI
Общие сведения о последовательности задач . Установка переменной последовательности задач развертывания операционной системы

Поделиться через