Compartilhar via


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:

  1. Indefinido: definido quando a etapa da sequência de tarefas Instalar Aplicativo não foi executada.

  2. Erro: definido quando, pelo menos, um aplicativo falhou devido a um erro durante a etapa da sequência de tarefas Instalar Aplicativo.

  3. Aviso: definido quando não ocorrem erros durante a etapa da sequência de tarefas Instalar Aplicativo, mas um ou mais aplicativos, ou uma dependência necessária, não foram instalados pois um requisito não foi atingido.

  4. Êxito: definido quando não houver nenhum erro ou aviso detectado durante a etapa da sequência de tarefas Instalar Aplicativo.

_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:

  • SMS -Especifica que a sequência de tarefas é iniciada usando o cliente do Gerenciador de Configurações.

  • UFD - Especifica que a sequência de tarefas é iniciada usando mídia USB e que a mídia USB foi criada no Windows XP/2003.

  • UFD+FORMAT - Especifica que a sequência de tarefas é iniciada usando mídia USB e que a mídia USB foi criada no Windows Vista ou posterior.

  • CD - Especifica que a sequência de tarefas é iniciada usando um CD.

  • DVD - Especifica que a sequência de tarefas é iniciada usando um DVD.

  • PXE - Especifica que a sequência de tarefas é iniciada do PXE.

  • HD – Especifica que a sequência de tarefas foi iniciada de um disco rígido (somente mídia pré-configurada).

_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:

  • true - Especifica que a sequência de tarefas é iniciada manualmente por um usuário por meio do Centro de Software.

  • false - Especifica que a sequência de tarefas é iniciada automaticamente pelo Agendador do Gerenciador de Configurações.

_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:

  • Auto: A sequência de tarefas cria uma relação entre os usuários especificados e o computador de destino quando implanta o sistema operacional no computador de destino.

  • Pendente: a sequência de tarefas cria uma relação entre o usuário especificado e o computador de destino, mas espera a aprovação do usuário administrativo antes de a relação ser definida.

  • Desabilitado: A sequência de tarefas não associa os usuários ao computador de destino quando implanta o sistema operacional.

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.