Variáveis internas de sequência de tarefas 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
Variáveis internas de sequência de tarefas são fornecidas pelo System Center 2012 Configuration Manager. Variáveis internas fornecem informações sobre o ambiente em que a sequência de tarefas está executando e seus valores estão disponíveis em toda a sequência de tarefas. Normalmente, as variáveis internas são inicializadas antes de as etapas serem executadas na sequência de tarefas. Por exemplo, a variável interna _SMSTSLogPath é uma variável de ambiente que especifica o caminho que os componentes do Gerenciador de Configurações usam para gravar arquivos de log enquanto a sequência de tarefas é executada; qualquer etapa de sequência de tarefas pode acessar essa variável de ambiente. No entanto, algumas variáveis, como _SMSTSCurrentActionName, são avaliadas antes de cada etapa. Os valores das variáveis internas são geralmente somente leitura. Os valores são lidos apenas para variáveis internas com um nome que começa com um sublinhado.
Lista de variáveis internas de sequência tarefa
A lista a seguir descreve as variáveis internas que estão disponíveis em Gerenciador de Configurações:
Nome da variável interna |
Descrição |
|---|---|
_SMSTSAdvertID |
Armazena a ID exclusiva da atual implantação de sequência de tarefas em execução Ele usa o mesmo formato que uma ID de implantação de distribuição de software do Gerenciador de Configurações. Se a sequência de tarefas estiver sendo executada por meio de uma mídia autônoma, esta variável não será definida. Exemplo: ABC20001 |
_TSAppInstallStatus |
Para System Center 2012 R2 Configuration Manager e posterior: a sequência de tarefa define a variável _TSAppInstallStatus de acordo com o status de instalação para o aplicativo durante a etapa da sequência de tarefa Instalar Aplicativo. A sequência de tarefas define a variável com um dos seguintes valores:
|
_SMSTSBootImageID |
Armazena a ID do pacote de imagem de inicialização do Gerenciador de Configurações, se um pacote de imagem de inicialização estiver associado à sequência de tarefas em execução atual. A variável não será definida se nenhum pacote de imagem de inicialização do Gerenciador de Configurações estiver associado. Exemplo: ABC00001 |
_SMSTSBootUEFI |
Para o System Center 2012 Configuration Manager SP1 e posterior: A sequência de tarefas define a variável SMSTSBootUEFI quando ela detecta um computador no modo UEFI. |
_SMSTSClientGUID |
Armazena o valor GUID do cliente do Gerenciador de Configurações. Essa variável não é definida se estiver executando a sequência de tarefas de mídia autônoma. Exemplo: 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c |
_SMSTSCurrentActionName |
Especifica o nome da etapa de sequência de tarefas em execução no momento. Essa variável é definida antes que o gerenciador de sequência de tarefas seja executado a cada etapa individual. Exemplo: executar linha de comando |
_SMSTSDownloadOnDemand |
Definido como true se a sequência de tarefas atual estiver em execução no modo de download sob demanda, o que significa que o gerenciador de sequência de tarefas baixa o conteúdo localmente apenas quando ele precisar acessar o conteúdo. |
_SMSTSInWinPE |
Essa variável é definida como true quando a etapa atual está sendo executado no ambiente do Windows PE e como false se não for. Você pode testar essa variável de sequência de tarefas para determinar o ambiente do sistema operacional atual. |
_SMSTSLastActionRetCode |
Armazena o código de retorno que foi retornado pela última ação que foi executada. Essa variável pode ser usada como uma condição para determinar se a próxima etapa é executada. Exemplo: 0 |
_SMSTSLastActionSucceeded |
A variável é definida como true se a última ação foi bem-sucedida e a false se a última ação falhou. Se a última ação foi ignorada porque a etapa foi desabilitada ou a condição associada é avaliada como false, essa variável não é redefinida, o que significa que ela ainda mantém o valor para a ação anterior. |
_SMSTSLaunchMode |
Especifica o método de inicialização de sequência de tarefas. A sequência de tarefas pode ter os seguintes valores:
|
_SMSTSLogPath |
Armazena o caminho completo do diretório de log. Isso pode ser usado para determinar quais ações são registradas. Esse valor não é definido quando um disco rígido não estiver disponível. |
_SMSTSMachineName |
Armazena e especifica o nome do computador. Armazena o nome do computador que usará a sequência de tarefas para registrar todas as mensagens de status. Para alterar o nome do computador no novo sistema operacional, use a variável OSDComputerName. Exemplo: ABC |
_SMSTSMDataPath |
Especifica o caminho definido pela variável SMSTSLocalDataDrive. Quando você define SMSTSLocalDataDrive antes do início da sequência de tarefas, como ao definir uma variável de coleta, o Gerenciador de Configurações define a variável _SMSTSMDataPath depois que a sequência de tarefas é iniciada. |
_SMSTSMediaType |
Especifica o tipo de mídia que é usada para iniciar a instalação. Exemplos de tipos de mídia são mídia de inicialização, mídia cheia, PXE e mídia pré-configurada. |
_SMSTSMP |
Armazena o nome ou endereço IP de um ponto de gerenciamento do Gerenciador de Configurações. |
_SMSTSMPPort |
Armazena o número de porta do ponto de gerenciamento de um ponto de gerenciamento do Gerenciador de Configurações. Exemplo: 80 |
_SMSTSOrgName |
Armazena o nome do título de identidade visual exibido na caixa de diálogo de interface de usuário da sequência de tarefas em andamento. Exemplo: Empresa XYZ |
_SMSTSPackageID |
Armazena a ID da atual sequência de tarefas em execução Esta ID usa o mesmo formato que uma ID de pacote de software do Gerenciador de Configurações. Exemplo: HJT00001 |
_SMSTSPackageName |
Armazena o nome da sequência de tarefas atual em execução especificada pelo administrador do Gerenciador de Configurações quando ela é criada. Exemplo: Implantar a sequência de tarefas do Windows 7 |
_SMSTSRunFromDP |
Definido como true se a sequência de tarefas atual estiver em execução no modo de execução do ponto de distribuição, o que significa que o gerenciador de sequência de tarefas obtém o pacote necessário para compartilhamentos de ponto de distribuição. |
_SMSTSSiteCode |
Armazena o código do site do Gerenciador de Configurações. Exemplo: ABC |
_SMSTSType |
Especifica o tipo da sequência de tarefas em execução atual. Ele pode ter os seguintes valores: 1 - indica uma sequência de tarefas genéricas. 2 - indica uma sequência de tarefas de implantação do sistema operacional. |
_SMSTSTimezone |
A variável _SMSTSTimezone armazena as informações de fuso horário no seguinte formato (sem espaços): Diferença, DiferençaPadrão, DiferençaDoHorárioDeVerão, DataPadrão.wAno, wMês, wDiaDaSemana, wDia, wHora, wMinuto, wSegundo, wMilissegundos, DataDoHorárioDeVerão.wAno, wMês, wDiaDaSemana, wDia, wHora, wMinuto, wSegundo, wMilissegundos, NomePadrão, NomePadrão Exemplo: Para a hora do Leste dos Estados Unidos 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 oficial do Leste dos EUA, o horário de verão do Leste |
_SMSTSUseCRL |
Especifica se a sequência de tarefas usa a lista de revogação de certificado ao usar um certificado Secure Socket Layer (SSL) para se comunicar com o ponto de gerenciamento. |
_SMSTSUserStarted |
Especifica se uma sequência de tarefas é iniciada por um usuário. Essa variável é definida somente se a sequência de tarefas é iniciada por meio do Centro de Software. Por exemplo, se _SMSTSLaunchMode está definido como SMS. A variável pode ter os seguintes valores:
|
_SMSTSUseSSL |
Especifica se a sequência de tarefas usa SSL para se comunicar com o ponto de gerenciamento do Gerenciador de Configurações. Se seu site estiver em execução no modo nativo, o valor é definido como true. |
_SMSTSWTG |
Para o System Center 2012 Configuration Manager SP1 e posterior: Especifica se o computador está executando como um dispositivo Windows To Go. |
SMSTSAssignmentsDownloadInterval |
Para o System Center 2012 Configuration Manager SP1 e posterior: Use esta variável para especificar o número de segundos para aguardar antes que o cliente tente baixar a política desde a última tentativa (que não retornou nenhuma política). Por padrão, o cliente aguardará 0 segundos antes de tentar novamente. Você pode definir essa variável usando um comando prestart da mídia ou PXE. |
SMSTSAssignmentsDownloadRetry |
Para o System Center 2012 Configuration Manager SP1 e posterior: Use esta variável para especificar o número de vezes que um cliente tentará baixar a política depois que nenhuma política foi encontrada na primeira tentativa. Por padrão, o cliente tentará novamente 0 vezes. Você pode definir essa variável usando um comando prestart da mídia ou PXE. |
SMSTSAssignUsersMode |
Especifica como uma sequência de tarefas associa os usuários ao computador de destino. Defina a variável para um dos seguintes valores:
|
SMSTSDownloadProgram |
Para o System Center 2012 Configuration Manager SP1 e posterior: Use essa variável para especificar um Provedor de Conteúdo Alternativo (um programa de download usado para baixar o conteúdo em vez do download padrão do Gerenciador de Configurações) para a sequência de tarefas. Como parte do processo de download do conteúdo, a sequência de tarefas verifica a variável para um programa de download especificado. Se especificado, a sequência de tarefas executa o programa para realizar o download. |
SMSTSDownloadRetryCount |
Para System Center 2012 R2 Configuration Manager e posterior: use essa variável para especificar o número de vezes que o Gerenciador de Configurações tenta baixar conteúdo de um ponto de distribuição. Por padrão, o cliente tentará novamente 2 vezes. |
SMSTSDownloadRetryDelay |
Para System Center 2012 R2 Configuration Manager e posterior: use essa variável para especificar o número de segundos que o Gerenciador de Configurações aguarda antes de tentar baixar conteúdo novamente de um ponto de distribuição. Por padrão, o cliente aguardará 15 segundos antes de tentar novamente. |
SMSTSErrorDialogTimeout |
Quando ocorre um erro em uma sequência de tarefas, é exibida uma caixa de diálogo que é automaticamente descartada após um número de segundos especificado por essa variável. Por padrão, a caixa de diálogo é automaticamente descartada após 900 segundos (15 minutos). |
TSErrorOnWarning |
Para System Center 2012 R2 Configuration Manager e posterior: Use essa variável para especificar se o mecanismo de sequência de tarefas considera um aviso detectado como um erro durante a etapa de sequência de tarefas de instalação do aplicativo. A sequência de tarefas define a variável _TSAppInstallStatus de acordo com o Aviso quando um ou mais aplicativos, ou uma dependência necessária, não foram instalados pois um requisito não foi atendido. Quando você define a variável TSErrorOnWarning como True e a variável _TSAppInstallStatus é definida como Aviso, ele será tratado como um erro. Um valor de False é o comportamento padrão. |
SMSTSLanguageFolder |
Para o System Center 2012 Configuration Manager SP1 e posterior: Use essa variável para alterar o idioma de exibição de uma imagem de inicialização neutra de idioma. |
SMSTSLocalDataDrive |
Especifica onde os arquivos temporários são armazenados no computador de destino enquanto a sequência de tarefas está em execução. Essa variável deve ser definida antes do início da sequência de tarefas, como definindo uma variável de coleta. Depois de iniciada a sequência de tarefas, Gerenciador de Configurações define a variável _SMSTSMDataPath depois que a sequência de tarefas é iniciada. |
SMSTSMPListRequestTimeout |
Para System Center 2012 R2 Configuration Manager e posterior: Use essa variável para especificar quantos milissegundos uma sequência de tarefas espera antes de tentar instalar novamente um aplicativo após uma falha ao recuperar a lista de ponto de gerenciamento dos serviços de localização. Por padrão, a sequência de tarefas espera 60.000 milissegundos (60 segundos) antes de tentar novamente a etapa e repetições até três vezes. Essa variável é aplicável somente para a etapa de sequência de tarefas Instalar Aplicativo. |
SMSTSPersistContent |
Para o System Center 2012 Configuration Manager SP1 e posterior: Use essa variável para manter temporariamente o conteúdo no 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 sequência de tarefas. Por exemplo, você pode usar essa variável para especificar um script que permite filtros de gravação em dispositivos inseridos depois que o a sequência de tarefas implanta um sistema operacional no dispositivo. |
SMSTSPreferredAdvertID |
Força uma implantação direcionada específica no computador de destino a ser executada. Isso pode ser definido por meio de um comando pré-início da mídia ou PXE. Se essa variável for definida, a sequência de tarefas substitui todas as implantações necessárias. |
OSDPreserveDriveLetter |
Para o System Center 2012 Configuration Manager SP1 e posterior: Essa variável determina se a sequência de tarefas usa ou não a letra da unidade capturada no arquivo WIM da imagem do sistema operacional ao aplicar essa imagem em um computador de destino. No Gerenciador de Configurações sem service pack, a letra da unidade capturada no arquivo WIM é usada quando aplicável ao arquivo WIM da imagem do sistema operacional. No Gerenciador de Configurações SP1, é possível definir o valor desta variável como Falso para usar o local especificado para a configuração Destino na etapa da sequência de tarefas Aplicar Sistema Operacional. Para obter mais informações sobre a etapa de sequência de tarefas Aplicar Sistema Operacional, consulte a seção Aplicar Imagem de Sistema Operacional no tópico Etapas de sequência de tarefas no Configuration Manager. |
SMSTSRebootDelay |
Especifica o número de segundos a esperar antes do computador ser reiniciado. O Gerenciador de sequência de tarefas exibirá uma caixa de diálogo de notificação antes da reinicialização, se essa variável não for definida como 0. Exemplos: 0 30 |
SMSTSRebootMessage |
Especifica a mensagem a ser exibida na caixa de diálogo de desligamento quando for solicitada uma reinicialização. Se essa variável não for definida, será exibida uma mensagem padrão. Exemplo: Este computador está sendo reiniciado pelo Gerenciador de sequência de tarefas. |
SMSTSRebootRequested |
Indica que uma reinicialização será solicitada após a etapa da sequência de tarefas atual ser concluída. Se uma reinicialização for necessária, basta definir essa variável como true, e o Gerenciador de sequência de tarefas reiniciará o computador após essa etapa de sequência de tarefas. A etapa de sequência de tarefas deve definir essa variável de sequência de tarefas se exigir a reinicialização para concluir a etapa de sequência de tarefas. Depois que o computador for reiniciado, a sequência de tarefas continuará sendo executada na próxima etapa de sequência de tarefas. |
SMSTSRetryRequested |
Solicita uma nova tentativa após a etapa atual ser concluída. Se essa variável de sequência de tarefas for definida, o SMSTSRebootRequested também deve ser definido como true. Depois que o computador for reiniciado, o Gerenciador de sequência de tarefas executará novamente a mesma etapa de sequência de tarefas. |
SMSTSUDAUsers |
Especifica o usuário principal do computador de destino. Especifique os usuários usando o seguinte formato. Separe vários usuários usando uma vírgula (,). Exemplo: domínio\usuário1, domínio\usuário2, domínio\usuário3 Para obter mais informações sobre como associar usuários ao computador de destino, consulte Como associar usuários a um computador de destino. |