Variáveis de Sequência de Tarefas Incorporadas no Configuration Manager
Aplica-se a: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 Configuration Manager SP2, System Center 2012 R2 Configuration Manager, System Center 2012 R2 Configuration Manager SP1
As variáveis incorporadas de sequência de tarefas são fornecidas pelo System Center 2012 Configuration Manager. As variáveis incorporadas fornecem informações sobre o ambiente onde a sequência de tarefas é executada e os seus valores encontram-se disponíveis ao longo de toda a sequência de tarefas. Normalmente, as variáveis incorporadas são inicializadas antes de os passos serem executados na sequência de tarefas. Por exemplo, a variável incorporada _SMSTSLogPath é uma variável de ambiente que especifica o caminho que os componentes do Gestor de configuração utilizam para escrever ficheiros de registo enquanto a sequência de tarefas é executada. Qualquer passo de sequência de tarefas pode aceder a esta variável de ambiente. No entanto, algumas variáveis, como a _SMSTSCurrentActionName, são avaliadas antes de cada passo. Os valores das variáveis incorporadas são, geralmente, só de leitura. Os valores são só de leitura para variáveis incorporadas com um nome que comece com um caráter de sublinhado.
Lista de Variáveis Incorporadas de Sequência de Tarefas
A lista seguinte descreve as variáveis incorporadas que se encontram disponíveis no Gestor de configuração:
Nome da Variável Incorporada |
Descrição |
|---|---|
_SMSTSAdvertID |
Armazena o ID exclusivo de implementação da sequência de tarefas atualmente em execução. Utiliza o mesmo formato que um ID de implementação de distribuição de software do Gestor de configuração. Se a sequência de tarefas for executada a partir de um suporte de dados autónomo, esta variável é indefinida. Exemplo: ABC20001 |
_TSAppInstallStatus |
Para o System Center 2012 R2 Configuration Manager e posterior: a sequência de tarefas define a variável _TSAppInstallStatus com o estado de instalação da aplicação durante o passo Instalar Aplicação da sequência de tarefas. A sequência de tarefas define a variável com um dos seguintes valores:
|
_SMSTSBootImageID |
Armazena o ID do pacote de imagem de arranque do Gestor de configuração, caso um pacote de imagem de arranque esteja associado à sequência de tarefas em execução atual. A variável não será definida se não estiver associado um pacote de imagem de arranque do Gestor de configuração. Exemplo: ABC00001 |
_SMSTSBootUEFI |
Para o System Center 2012 Configuration Manager SP1 e posterior: A sequência de tarefas define a variável SMSTSBootUEFI sempre que deteta um computador que esteja no modo UEFI. |
_SMSTSClientGUID |
Armazena o valor do GUID do cliente do Gestor de configuração. Esta variável não é definida se a sequência de tarefas for executada a partir de um suporte de dados autónomo. Exemplo: 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c |
_SMSTSCurrentActionName |
Especifica o nome do passo da sequência de tarefas em execução atual. Esta variável é definida antes de o gestor da sequência de tarefas executar cada passo individual. Exemplo: executar linha de comandos |
_SMSTSDownloadOnDemand |
Definir como verdadeiro se a sequência de tarefas atual for executada no modo de transferência a pedido, o que significa que o gestor da sequência de tarefas transfere o conteúdo apenas localmente quando precisa de aceder ao conteúdo. |
_SMSTSInWinPE |
Esta variável é definida como verdadeiro quando o passo de sequência de tarefas atual estiver a ser executado no ambiente Windows PE e é definida como falso se não estiver. Pode testar esta variável de sequência de tarefas para determinar o ambiente do sistema operativo atual. |
_SMSTSLastActionRetCode |
Armazena o código de retorno devolvido pela última ação executada. Esta variável pode ser utilizada como uma condição para determinar se o próximo passo é executado. Exemplo: 0 |
_SMSTSLastActionSucceeded |
A variável é definida como verdadeiro se a última ação tiver sido executada com êxito e como falso se a última ação falhou. Se a última ação tiver sido ignorada porque o passo estava desativado ou a condição associada estava avaliada como falso, esta variável não é reposta, o que significa que ainda retém o valor da ação anterior. |
_SMSTSLaunchMode |
Especifica o método de início da sequência de tarefas. A sequência de tarefas pode ter os seguintes valores:
|
_SMSTSLogPath |
Armazena o caminho completo do diretório de registo. Este pode ser utilizado para determinar o local onde as ações são registadas. Este valor não é definido quando o disco rígido não se encontra disponível. |
_SMSTSMachineName |
Armazena e especifica o nome do computador. Armazena o nome do computador que a sequência de tarefas irá utilizar para registar todas as mensagens de estado. Para alterar o nome do computador no novo sistema operativo, utilize a variável OSDComputerName. Exemplo: ABC |
_SMSTSMDataPath |
Especifica o caminho definido pela variável SMSTSLocalDataDrive. Ao definir SMSTSLocalDataDrive antes de a sequência de tarefas ser iniciada, como, por exemplo, definindo uma variável de coleção, o Gestor de configuração define a variável _SMSTSMDataPath assim que a sequência de tarefas for iniciada. |
_SMSTSMediaType |
Especifica o tipo de suporte de dados utilizado para iniciar a instalação. Exemplos de tipos de suportes de dados: Suporte de Dados de Arranque, Suporte de Dados Completo, PXE e Suporte de Dados Pré-configurado. |
_SMSTSMP |
Armazena o nome ou o endereço IP de um ponto de gestão do Gestor de configuração. |
_SMSTSMPPort |
Armazena o número de porta do ponto de gestão de um ponto de gestão do Gestor de configuração. Exemplo: 80 |
_SMSTSOrgName |
Armazena o nome do título da imagem corporativa apresentado numa caixa de diálogo da interface de utilizador de progresso da sequência de tarefas. Exemplo: Organização XYZ |
_SMSTSPackageID |
Armazena o ID da sequência de tarefas atualmente em execução. Este ID utiliza o mesmo formato que um ID de pacote de software do Gestor de configuração. Exemplo: HJT00001 |
_SMSTSPackageName |
Armazena o nome da sequência de tarefas atualmente em execução, especificado pelo administrador do Gestor de configuração quando a sequência de tarefas é criada. Exemplo: Implementar sequência de tarefas do Windows 7 |
_SMSTSRunFromDP |
Definir como verdadeiro se a sequência de tarefas atual for executada no modo de execução a partir do ponto de distribuição, o que significa que o gestor da sequência de tarefas obtém partilhas de pacotes do ponto de distribuição. |
_SMSTSSiteCode |
Armazena o código do site do Gestor de configuração. Exemplo: ABC |
_SMSTSType |
Especifica o tipo da sequência de tarefas atualmente em execução. Pode ter os seguintes valores: 1 - indica uma sequência de tarefas genérica. 2 - indica uma sequência de tarefas de implementação do sistema operativo. |
_SMSTSTimezone |
A variável _SMSTSTimezone armazena as informações de fuso horário no seguinte formato (sem espaços): Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName Exemplo: Para a Hora do Leste E.U.A. e Canadá, o valor seria 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Hora Padrão do Leste,Hora de Verão do Leste |
_SMSTSUseCRL |
Especifica se a sequência de tarefas utiliza a lista de revogação de certificados quando utiliza um certificado SSL (Secure Socket Layer) para comunicar com o ponto de gestão. |
_SMSTSUserStarted |
Especifica se uma sequência de tarefas é iniciada por um utilizador. Esta variável é definida apenas se a sequência de tarefas for iniciada a partir do Centro de Software. Por exemplo, se _SMSTSLaunchMode estiver definido como SMS. A variável pode ter os seguintes valores:
|
_SMSTSUseSSL |
Especifica se a sequência de tarefas utiliza SSL para comunicar com o ponto de gestão do Gestor de configuração. Se o seu site for executado no modo nativo, o valor é definido como verdadeiro. |
_SMSTSWTG |
Para o System Center 2012 Configuration Manager SP1 e posterior: Especifica se o computador está a ser executado como um dispositivo Windows To Go. |
SMSTSAssignmentsDownloadInterval |
Para o System Center 2012 Configuration Manager SP1 e posterior: Utilize esta variável para especificar o número de segundos a aguardar antes de o cliente tentar transferir a política desde a última tentativa (que não tenha devolvido políticas). Por predefinição, o cliente irá aguardar 0 segundos antes de tentar. Pode definir esta variável utilizando um comando de pré-início do suporte de dados ou do PXE. |
SMSTSAssignmentsDownloadRetry |
Para o System Center 2012 Configuration Manager SP1 e posterior: Utilize esta variável para especificar o número de vezes que o cliente irá tentar transferir a política caso não sejam encontradas políticas durante a primeira tentativa. Por predefinição, o cliente irá repetir 0 vezes. Pode definir esta variável utilizando um comando de pré-início do suporte de dados ou do PXE. |
SMSTSAssignUsersMode |
Especifica como uma sequência de tarefas associa os utilizadores ao computador de destino. Defina a variável como um dos seguintes valores.
|
SMSTSDownloadProgram |
Para o System Center 2012 Configuration Manager SP1 e posterior: Utilize esta variável para especificar um Fornecedor Alternativo de Conteúdos, um programa de transferência que é utilizado para transferir conteúdos em substituição do programa de transferência predefinido do Gestor de configuração, para a sequência de tarefas. No âmbito do processo de transferência de conteúdos, a sequência de tarefas analisa a variável para identificar um programa de transferência especificado. Se for especificada, a sequência de tarefas executará o programa para efetuar a transferência. |
SMSTSDownloadRetryCount |
Para o System Center 2012 R2 Configuration Manager e posterior: utilize esta variável para especificar o número de vezes que o Gestor de configuração tenta transferir conteúdo a partir de um ponto de distribuição. Por predefinição, o cliente irá repetir a ação 2 vezes. |
SMSTSDownloadRetryDelay |
Para o System Center 2012 R2 Configuration Manager e posterior: utilize esta variável para especificar o número de segundos que o Gestor de configuração aguarda antes de tentar transferir novamente conteúdo a partir de um ponto de distribuição. Por predefinição, o cliente irá aguardar 15 segundos antes de tentar novamente. |
SMSTSErrorDialogTimeout |
Quando ocorre um erro numa sequência de tarefas, é apresentada uma caixa de diálogo que é automaticamente dispensada após um número de segundos especificado por esta variável. Por predefinição, a caixa de diálogo é automaticamente dispensada após 900 segundos (15 minutos). |
TSErrorOnWarning |
Para o System Center 2012 R2 Configuration Manager e posterior: Utilize esta variável para especificar se o motor da sequência de tarefas considera um aviso detetado como um erro durante o passo de sequência de tarefas de Instalação da Aplicação. A sequência de tarefas define a variável _TSAppInstallStatus como Aviso quando uma ou mais aplicações, ou uma dependência necessária, não foi instalada porque não foi cumprido um requisito. Ao definir a variável TSErrorOnWarning como Verdadeiro e a variável _TSAppInstallStatus está definida como Aviso, esta é tratada como um erro. Um valor de Falso corresponde ao comportamento predefinido. |
SMSTSLanguageFolder |
Para o System Center 2012 Configuration Manager SP1 e posterior: Utilize esta variável para alterar o idioma de apresentação de uma imagem de arranque de idioma neutro. |
SMSTSLocalDataDrive |
Especifica onde os ficheiros temporários são armazenados no computador de destino enquanto a sequência de tarefas é executada. Esta variável tem de ser definida antes de a sequência de tarefas ser iniciada, como, por exemplo, definindo uma variável de coleção. Assim que a sequência de tarefas for iniciada, o Gestor de configuração define a variável _SMSTSMDataPath. |
SMSTSMPListRequestTimeout |
Para o System Center 2012 R2 Configuration Manager e posterior: Utilize esta variável para especificar quantos milissegundos uma sequência de tarefas aguarda antes de tentar instalar novamente uma aplicação depois de não ter conseguido obter a lista de pontos de gestão a partir dos serviços de localização. Por predefinição, a sequência de tarefas aguarda 60 000 milissegundos (60 segundos) antes de repetir o passo e repete até três vezes. Esta variável é aplicável apenas ao passo Instalar Aplicação da sequência de tarefas. |
SMSTSPersistContent |
Para o System Center 2012 Configuration Manager SP1 e posterior: Utilize esta variável para manter temporariamente o conteúdo na cache da sequência de tarefas. |
SMSTSPostAction |
Para o System Center 2012 Configuration Manager SP1 e posterior: Especifica um comando que é executado após a conclusão da sequência de tarefas. Por exemplo, pode utilizar esta variável para especificar um script que ativa filtros de escrita em dispositivos incorporados após a sequência de tarefas implementar um sistema operativo no dispositivo. |
SMSTSPreferredAdvertID |
Força uma implementação direcionada específica no computador de destino a ser executado. Esta pode ser definida através de um comando de pré-início a partir de um suporte de dados ou PXE. Se esta variável for definida, a sequência de tarefas substitui quaisquer implementações necessárias. |
OSDPreserveDriveLetter |
Para o System Center 2012 Configuration Manager SP1 e posterior: Esta variável determina se a sequência de tarefas utiliza ou não a letra de unidade capturada no ficheiro WIM da imagem do sistema operativo ao aplicar essa imagem a um computador de destino. No Gestor de configuração sem service packs, a letra de unidade capturada no ficheiro WIM é utilizada ao aplicar o ficheiro WIM da imagem do sistema operativo. O Gestor de configuração SP1 permite definir o valor desta variável para Falso para utilizar a localização especificada na definição Destino do passo da sequência de tarefas Aplicar Sistema Operativo. Para mais informações sobre o passo da sequência de tarefas Aplicar Sistema Operativo, consulte a secção Aplicar Imagem do Sistema Operativo do tópico Passos de Sequência de Tarefas no Configuration Manager. |
SMSTSRebootDelay |
Especifica quantos segundos deve aguardar até que o computador seja reiniciado. O gestor da sequência de tarefas irá apresentar um diálogo de notificação antes de reiniciar, caso esta variável não esteja definida como 0. Exemplos: 0 30 |
SMSTSRebootMessage |
Especifica a mensagem a apresentar na caixa de diálogo de encerramento quando é pedido um reinício. Se esta variável não for definida, será apresentada uma mensagem predefinida. Exemplo: Este computador está a ser reiniciado pelo gestor de sequência de tarefas. |
SMSTSRebootRequested |
Indica que é pedido um reinício após a conclusão do passo de sequência de tarefas atual. Se for necessário reiniciar, basta definir esta variável como verdadeiro e o gestor da sequência de tarefas irá reiniciar o computador após este passo da sequência de tarefas. O passo da sequência de tarefas tem de definir esta variável de sequência de tarefas, caso precise do reinício para concluir o passo da sequência de tarefas. Após o reinício do computador, a sequência de tarefas irá continuar a ser executada a partir do passo seguinte da sequência de tarefas. |
SMSTSRetryRequested |
Pede uma repetição após a conclusão do passo de sequência de tarefas atual. Se esta variável de sequência de tarefas estiver definida, a variável SMSTSRebootRequested também tem de estar definida como verdadeiro. Após o reinício do computador, o gestor da sequência de tarefas irá executar novamente o mesmo passo da sequência de tarefas. |
SMSTSUDAUsers |
Especifica o utilizador primário do computador de destino. Especifique os utilizadores, utilizando o seguinte formato. Separe múltiplos utilizadores com uma vírgula (,). Exemplo: domínio\utilizador1, domínio\utilizador2, domínio\utilizador3 Para mais informações sobre a associação de utilizadores ao computador de destino, consulte Como Associar Utilizadores a um Computador de Destino. |