How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence (Como Utilizar Variáveis de Sequência de Tarefas numa Sequência de Tarefas em Execução Configuration Manager)

2025-06-06

No Configuration Manager, pode criar, obter e definir variáveis de sequência de tarefas numa sequência de tarefas em execução com o objeto de automatização COM do ambiente de sequência de tarefas (Microsoft.SMS.TSEnvironment).

Normalmente, utiliza uma ação de linha de comandos que executa um script para aceder às variáveis de sequência de tarefas. No entanto, também pode aceder aos mesmos, numa sequência de tarefas em execução, através de qualquer ambiente de programação que possa utilizar objetos de automatização COM.

Observação

Quando define uma variável de tarefa no cliente Configuration Manager, esta fica disponível para os passos subsequentes na sequência de tarefas.

Para criar uma variável de sequência de tarefas personalizada, defina uma Microsoft.SMS.TSEnvironment propriedade com o nome da nova variável que pretende criar. Se a variável ainda não existir, é criada. Se a variável já existir, o respetivo valor é atualizado. Mais tarde, pode obter o valor da variável personalizada a partir de Microsoft.SMS.TSEnvironment.

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

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

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

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

Para aceder FileSystem a esta matriz, utilizaria OSDPartitions0FileSystem. Se a matriz for maior, utilizaráOSDPartitions1FileSystem para o segundo elemento e assim sucessivamente através da matriz.

Não é recomendado que utilize código gerido com o ambiente de sequenciação de tarefas, uma vez que não pode utilizá-lo nos seguintes ambientes:

Windows PE
Windows Server 2008
Windows 2000

O código gerido funciona quando o sistema operativo completo está em execução com a versão correta do .NET Framework instalada.

A versão do .NET Framework necessária depende da versão do Visual Studio que utilizar.

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

Terá de utilizar o interoperabilidade COM para aceder ao TSEnvironment objeto. Você precisará do seguinte:

Referência à Biblioteca de Tipos TSEnvironment 1.0.
O espaço de nomes TSEnvironmentLib .

Para utilizar variáveis de tarefa numa sequência de tarefas em execução

Numa 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 seguinte método de exemplo obtém a _SMSTSLogPath variável . 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, veja Chamar Configuration Manager Fragmentos 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 sequenciação de tarefas de Implementação do Sistema Operativo

Programação robusta

Para obter mais informações sobre o processamento de erros, veja About Configuration Manager Errors (Acerca dos Erros de Configuration Manager).

Segurança do .NET Framework

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

Confira também

Descrição geral de Objetos Como Ligar a um Fornecedor de SMS no Configuration Manager ao Utilizar Código Gerido Como Ligar a um Fornecedor de SMS no Configuration Manager através da descrição geral da sequência de tarefas WMI Como Definir uma Variável de Sequência de Tarefas de Implementação do Sistema Operativo

Compartilhar via