Next Topic

Previous Topic

Book Contents

Uso de variáveis

Use as variáveis para armazenar valores que podem ser referenciados em várias etapas de procedimentos. As variáveis são passadas, automaticamente, para procedimentos aninhados.

  • Dois métodos para criação de variáveis:
    • Variáveis de procedimentos - Use o comando Obter variável em um procedimento para criar um novo nome de variável sem nenhum caractere especial. Exemplo: NomeVariável. Em etapas posteriores, incluindo etapas em procedimentos aninhados, referencie a variável colocando-a entre os caracteres #. Exemplo: #NomeVariável#. As variáveis de procedimento não podem ser referenciadas fora do procedimento ou dos procedimentos aninhados que as usam.
    • Variáveis gerenciadas - Use o Gerenciador de variáveis para definir as variáveis que podem ser usadas repetidamente em diferentes procedimentos. Você pode manter vários valores para cada variável gerenciada, com cada valor aplicado a uma ou mais IDs de grupo. As variáveis gerenciadas não podem ter novos valores reatribuídos durante um procedimento. Durante um procedimento, referencie uma variável gerenciada colocando o nome dela entre os caracteres < e >. Exemplo: <NomeVariável>.
  • Onde usadas - Depois de as variáveis terem sido criadas, elas poderão ser incluídas, entre caracteres especiais (<>, #), em qualquer campo de entrada de texto exibido por uma caixa de diálogo IF-ELSE-STEP.
  • Diferenciação entre maiúsculas e minúsculas - Os nomes de variáveis fazem diferenciação entre maiúsculas e minúsculas.
  • Caracteres reservados - Como os caracteres <, > e # são usados para identificar nomes de variáveis, eles deverão ser inseridos duas vezes como texto comum em uma linha de comando. Por exemplo, o comando c:\dir >> filelist.txt é interpretado no tempo de execução do procedimento como c:\dir > filelist.txt.
  • Tipos de valores de variáveis possíveis - A seguir, estão os tipos de valores de variáveis normalmente obtidos usando o parâmetro Obter variável.
    • Valor do registro - Dados do valor do registro especificado na máquina gerenciada.
    • Conteúdo do arquivo - Dados de um arquivo especificado na máquina gerenciada.
    • Valor constante - Constante especificada conforme digitado no editor de procedimentos.
    • Caminho do diretório de instalação do agente - Diretório em que o agente está instalado na máquina gerenciada.
    • Unidade de instalação do agente - Unidade em que o agente está instalado na máquina gerenciada, como, por exemplo, c:\.
    • Caminho do diretório de trabalho do agente - O diretório de trabalho na máquina gerenciada, conforme especificado usando Agente > Diretório de trabalho.

      Aviso: Não exclua arquivos e pastas do diretório de trabalho. O agente usa os dados armazenados no diretório de trabalho para executar várias tarefas.

    • Caminho do diretório temporário do usuário - O diretório temporário para o usuário conectado na máquina gerenciada no momento. Esse caminho é a expansão da variável de ambiente %TEMP% para o usuário conectado no momento. Se nenhum usuário estiver conectado, será o diretório temporário padrão do Windows.
    • ID de máquina.ID de grupo - ID de máquina do agente que executa o procedimento.
    • Número de versão do arquivo - O número de versão do software do arquivo especificado na máquina gerenciada. Por exemplo, um arquivo exe ou dll normalmente contém o número de versão de sua versão.
    • Tamanho do arquivo - Tamanho, em bytes, do arquivo especificado na máquina gerenciada.
    • Data da última modificação do arquivo - A data e a hora da última modificação no horário universal coordenado (UTC) do arquivo especificado na máquina gerenciada no formato de aaaa/mm/dd hh:mm:ss.
    • Dados do SQL View - Use o comando Obter variável com a opção Dados do SQL View para criar uma nova variável de procedimento e defini-la como o valor de um valor dbo.SqlView.Coluna. Use o formato NomeSqlView/NomeColuna/ID máquina.ID grupo ou NomeSqlView/NomeColuna. Se a ID de máquina opcional for omitida, o valor para o agente que executa o procedimento será recuperado. Se NomeColuna contiver um espaço,  coloque-o entre parêntesis. Exemplo: vSystemInfo/[Nome do produto]. Consulte Sistema > Visualizações de bancos de dados para obter uma lista das visualizações e colunas SQL disponíveis.

      <observação> - Variáveis de dados SQL View automáticas - Os parâmetros de visualização SQL estão disponíveis, como variáveis de procedimento automaticamente declaradas. As variáveis automáticas permitem ignorar, usando o comando Obter Variável com a opção Dados do SQL View. Use o formato #NomeSqlView.NomeColuna# em um procedimento para retornar o valor de dbo.SqlView.Coluna para o agente que executa o procedimento.

    • Propriedade WMI - Um espaço de nome, classe e propriedade WMI. O formato da propriedade WMI especificada é EspaçoDeNome:Classe.Propriedade. Por exemplo, root\cimv2:Win32_OperatingSystem.FreePhysicalMemory. Especifique uma instância usando a seguinte sintaxe: EspaçoNome:Classe[N].Propriedade onde [N] é o número da instância. Por exemplo, root\cimv2:Win32_DispositivoIntegrado[3].Descrição. A primeira instância pode ser especificada com ou sem especificação do número da instância [1].
    • Valor da expressão - Especifica uma expressão que consiste em variáveis de procedimento e seis operadores matemáticos +, -, *, /, ( e ) que são avaliados e atribuídos a uma nova variável de procedimento. Por exemplo, ((#variável1# + #variável2#) + 17.4) / (#variável3# * 4). As variáveis de procedimento deverão conter valores numéricos.
    • Valor do registro de 64 bits - Dados do valor do registro especificado na máquina gerenciada.
    • Solicitar quando o procedimento for programado- Exibe um prompt de mensagem para inserir um valor quando um procedimento . O valor é armazenado no nome de variável que você especifica. Especifique o texto do prompt e o nome da variável. Por exemplo, toda vez que esse procedimento for executado, um usuário do VSA poderá inserir um diretório de máquina diferente.