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

No 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 da sequência de tarefas. Mas você também pode acessá-los, em uma execução de uma sequência de tarefas, usando qualquer ambiente de programação que possa usar objetos de automação COM.

Para criar uma variável de sequência de tarefas personalizada, defina uma Microsoft.SMS.TSEnvironment propriedade usando o nome da nova variável que deseja criar. Se a variável ainda não existir, ela é criada. Se a variável já existir, seu valor será atualizado. Posteriormente, você poderá obter o valor da variável personalizada em 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 exemplo a seguir representa uma matriz de um elemento OSDPartitions :

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

Para acessar FileSystem nesta matriz, você usaria OSDPartitions0FileSystem. Se a matriz for maior, você usariaOSDPartitions1FileSystem para o segundo elemento e assim por diante na matriz.

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

• Windows PE

• Windows Server 2008

• Windows 2000

  O código gerenciado funciona quando o sistema operacional completo está sendo executado 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 você usa.

Você precisará usar a 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

1. Em uma sequência de tarefas em execução, crie uma instância de Microsoft.SMS.TSEnvironment.

2. Obtenha ou defina a variável de ambiente necessária.

Exemplo

O método de exemplo a seguir obtém a _SMSTSLogPath variável. Ela 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 trechos de código do 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

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 do Configuration Manager.

Segurança do .NET Framework

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

Confira também

Visão geral de objetosComo se conectar a um provedor SMS no Configuration Manager usando código gerenciadoComo se conectar a um provedor SMS no Configuration Manager usando WMIVisão geral da sequência de tarefasComo definir uma implantação de sistema operacional Variável de Sequência de Tarefas