Como usar variáveis de sequência de tarefas em uma sequência de tarefas em execução Configuration Manager

Artigo
04/04/2023

Em Configuration Manager, você pode criar, obter e definir variáveis de sequência de tarefas em uma sequência de tarefas em execução usando o objeto de automação COM do ambiente de sequência de tarefas (Microsoft.SMS.TSEnvironment).

Normalmente, você usa uma ação de linha de comando que executa um script para acessar as variáveis de sequência de tarefas. Mas você também pode acessá-los, em uma sequência de tarefas em execução, usando qualquer ambiente de programação que possa usar objetos de automação COM.

Observação

Quando você define uma variável de tarefa no Configuration Manager cliente, ela fica disponível para as etapas subsequentes na sequência de tarefas.

Para criar uma variável de sequência de tarefas personalizada, você define uma Microsoft.SMS.TSEnvironment propriedade usando o nome da nova variável que deseja criar. Se a variável ainda não existir, ela será criada. Se a variável já existir, seu valor será atualizado. Posteriormente, você pode obter o valor da variável personalizada de Microsoft.SMS.TSEnvironment.

Quando uma variável de sequência de tarefas é uma matriz, ela é passada no seguinte formato:

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

Por exemplo, a OSDPartitions variável é uma matriz de SMS_TaskSequencePartitionSettings. O seguinte representa uma matriz de um elemento OSDPartitions :

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

Para acessar FileSystem essa matriz, você usaria OSDPartitions0FileSystem. Se a matriz for maior, você usaráOSDPartitions1FileSystem para o segundo elemento e assim por diante por meio da matriz.

Não é recomendável que você use o código gerenciado com o ambiente de sequenciamento de tarefas porque não é possível usá-lo nos seguintes ambientes:

Windows PE
Windows Server 2008
Windows 2000

O código gerenciado funciona quando o sistema operacional completo está em execução com a versão correta do .NET Framework instalado.

A versão de .NET Framework necessária depende da versão do Visual Studio que você usa.

Visual Studio	versão .NET Framework
Visual Studio 2003	1.0
Visual Studio 2005	2.0
Visual Studio 2008	2.0 a 3.5

Você precisará usar o interoperabilidade COM para acessar o TSEnvironment objeto. Você precisará do seguinte:

Referência à Biblioteca de Tipos TSEnvironment 1.0.
O namespace TSEnvironmentLib .

Para usar variáveis de tarefa em uma sequência de tarefas em execução

Em uma sequência de tarefas em execução, crie uma instância de Microsoft.SMS.TSEnvironment.
Obtenha ou defina a variável de ambiente necessária.

Exemplo

O método de exemplo a seguir obtém a _SMSTSLogPath variável. Ele também define o valor de uma variável personalizada e um valor de variável personalizada de matriz.

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets de Código.

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

Compilando o código

Plataformas

Ambiente de sequenciamento de tarefas de implantação do sistema operacional

Programação robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre erros de Configuration Manager.

Segurança do .NET Framework

Para obter mais informações sobre como proteger aplicativos Configuration Manager, consulte Configuration Manager administração baseada em função.

Confira também

Visão geral de objetos Como se conectar a um provedor de SMS no Configuration Manager usando código gerenciado
Como se conectar a um provedor de SMS no Configuration Manager usando o WMI
Visão geral da sequência de tarefas Como definir uma variável de sequência de tarefas de implantação do sistema operacional