Como utilizar variáveis de sequência de tarefas numa sequência de tarefas do gestor de configuração em execução
No Gestor de Configuração, pode criar, obter e definir variáveis de sequência de tarefas numa sequência de tarefas em execução utilizando o objeto de automatização COM do ambiente de sequência de tarefas Microsoft.SMS.TSEnvironment ().
Normalmente, usa-se uma ação de linha de comando que executa um script para aceder às variáveis da sequência de tarefas. Mas também pode aceder-lhes, dentro de uma sequência de tarefas, utilizando qualquer ambiente de programação que possa utilizar objetos de automatização COM.
Nota
Quando define uma variável de tarefa no cliente Gestor de Configuração, fica disponível para passos subsequentes na sequência de tarefas.
Para criar uma variável de sequência de tarefa personalizada, você define uma Microsoft.SMS.TSEnvironment propriedade usando o nome da nova variável que pretende criar. Se a variável já não existe, é criada. Se a variável já existe, o seu valor é atualizado. Posteriormente, pode obter o valor variável personalizado a partir de Microsoft.SMS.TSEnvironment .
Quando uma variável de sequência de tarefa é uma matriz, é passada no seguinte formato:
<base array name><element #><Property>="value".
Por exemplo, a OSDPartitions variável é uma matriz de SMS_TaskSequencePartitionSettings . O seguinte representa um elemento OSDPartitions Array:
OSDPartitions0Bootable="true"
OSDPartitions0FileSystem="NTFS"
OSDPartition0QuickFormat="false"
OSDPartitions0Size="100"
OSDPartitions0SizeUnits="Percent"
OSDPartitions0Type="Primary"
Para aceder FileSystem a esta matriz, você usaria OSDPartitions0FileSystem . Se a matriz for maior, usaria OSDPartitions1FileSystem para o segundo elemento e assim por diante através da matriz.
Não é recomendável que utilize código gerido com o ambiente de sequenciação de tarefas, pois não pode usá-lo nos seguintes ambientes:
Windows PE
Windows Server 2008
Windows 2000
O código gerido funciona quando o sistema operativo completo está a funcionar com a versão correta de .NET Framework instalada.
A versão de .NET Framework que é necessária depende da versão de Visual Studio que utiliza.
| 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 interop COM para aceder ao TSEnvironment objeto. Será necessário o seguinte:
Referência à Biblioteca tipo TSEnvironment 1.0.
O espaço de nome TSEnvironmentLib.
Para utilizar variáveis de tarefa numa sequência de tarefa em execução
Numa sequência de tarefas em execução, crie uma instância de
Microsoft.SMS.TSEnvironment.Obtenha ou desaprova a variável 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 variável personalizado de matriz.
Para obter informações sobre a chamada do código de amostra, consulte o Código de Identificação do Gestor de Chamadas.
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
A Compilar 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 tratamento de erros, consulte Sobre erros do Gestor de Configuração.
Segurança do .NET Framework
Para obter mais informações sobre a segurança das aplicações do Gestor de Configuração, consulte a administração baseada em funções do Gestor de Configuração.
Consulte também
Visão geral de objetos Como Ligação a um fornecedor de SMS no Gestor de Configuração através da utilização do Código Gerido
Como Ligação a um fornecedor de SMS no Gestor de Configuração através da utilização do WMI
Visão geral da sequência de tarefas Como definir uma variável de sequência de tarefas de implementação do sistema operativo