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.

• Três métodos para criação de variáveis:
  • Variáveis de procedimentos: use o comando getVariable() em um procedimento para criar um novo nome de variável sem nenhum caractere especial. Exemplo: VariableName. Em etapas posteriores, incluindo etapas em procedimentos aninhados, referencie a variável colocando-a entre os caracteres #. Exemplo: #VariableName#.

  Nota: As variáveis de procedimento não podem ser referenciadas fora do procedimento ou dos procedimentos aninhados que as usam, com exceção das variáveis GLOBAL. Uma variável de procedimento está visível apenas na seção do procedimento no qual foi criada e em qualquer procedimento filho. Depois que o procedimento sair da cláusula THEN ou ELSE na qual a variável foi criada, a variável estará fora do escopo e não será mais válida. Use as Variáveis GLOBAL, descritas abaixo, para manter a visibilidade da variável após sair da cláusula THEN ou ELSE na qual a variável foi criada.

  • 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 ao colocar seu nome entre os caracteres < e >. Exemplo: <VariableName>.
  • Variáveis GLOBAL: variáveis não GLOBAL não podem retornar um valor alterado de uma variável de procedimento definido por seu procedimento pai. Variáveis não GLOBAL inicializadas no procedimento filho também não podem ser retornadas ao pai. As variáveis nomeadas com o prefixo GLOBAL: (sem diferenciação entre maiúsculas e minúsculas seguido de dois pontos) podem passar valores alterados de um filho para o pai, se a variável tiver sido inicializada no procedimento pai ou filho. Procedimentos filhos subsequentes podem fazer uso de qualquer variável GLOBAL inicializada em qualquer etapa anterior, independentemente de a variável ser inicializada em um procedimento pai ou em outro procedimento filho.
• Nomes de variáveis: nomes de variáveis não podem incluir os seguintes caracteres: , % ' " / \ : * ? < > | e o caractere de espaço.
• 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 seguinte comando c:\dir >> filelist.txt é interpretado em um tempo de execução de 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 ao usar o parâmetro getVariable().
  • Valor de registro e Valor de registro de 64 bits: consulte Comandos de 64 bits - Dados do valor de registro especificado na máquina gerenciada. A última barra única em uma sequência é usada para delimitar a chave de registro do valor de registro. Para incluir barras invertidas como parte da sequência de valor, especifique duas barras para cada caractere de barra. Por exemplo, a sequência HKEY_LOCAL_MACHINE\SOFTWARE\SomeKey\Value\\Name é interpretada como a chave HKEY_LOCAL_MACHINE\SOFTWARE\SomeKey com valor de Value\Name.
  • Conteúdo do arquivo - Dados de um arquivo especificado na máquina gerenciada. Consulte Comandos de 64 bits.
  • 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 na qual o agente está instalado na máquina gerenciada, como c:\.
  • Caminho do diretório de trabalho do agente: o diretório de trabalho na máquina gerenciada, conforme especificado em 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 da sua liberaçã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 yyyy/mm/dd hh:mm:ss.
  • Variáveis de dados do modo de exibição SQL automáticas: os parâmetros de exibição SQL estão disponíveis como variáveis de procedimento automaticamente declaradas. Variáveis automáticas permitem que você pare de usar o comando GetVariable antes de utilizar a variável em uma etapa. Use o formato #SqlViewName.ColumnName# em um procedimento para retornar o valor de dbo.SqlView.Column para o agente que executa o procedimento. Consulte Sistema > Visualizações de bancos de dados para obter uma lista dos modos de exibição e colunas SQL disponíveis.

    Nota: Dados do modo de exibição SQL: este método mais antigo de retornar um valor de visualização de banco de dados é necessário apenas se você estiver tentando retornar um valor de uma máquina diferente da máquina na qual o procedimento do agente está em execução.
    
    Use o comando GetVariable com a opção Dados do modo de exibição SQL para criar uma nova variável de procedimento e defini-la como o valor de um valor dbo.SqlView.Column. Use o formato SqlViewName/ColumnName/mach.groupID ou SqlViewName/ColumnName. Se a ID de máquina opcional for omitida, o valor para o agente que executa o procedimento será recuperado. Se ColumnName contiver um espaço, coloque-o entre parênteses. Exemplo: vSystemInfo/[Product Name].  Consulte Sistema > Visualizações de bancos de dados para obter uma lista das exibições e colunas SQL disponíveis.

  • Variáveis de administrador automáticas: três variáveis de administrador são declaradas automaticamente. Essas variáveis de administrador automáticas permitem que os procedimentos de agente acessem valores não presentes em uma visualização SQL.
    • #adminDefaults.adminEmail# : endereço de e-mail do usuário do VSA que agendou o procedimento do agente.
    • #adminDefaults.adminName#: nome do usuário do VSA que agendou o procedimento do agente.
    • #scriptIdTab.scriptName#: nome do procedimento do agente.
  • Propriedade WMI - Um espaço de nome, classe e propriedade WMI. O formato da propriedade WMI especificada é NameSpace:Class.Property. Por exemplo, root\cimv2:Win32_OperatingSystem.FreePhysicalMemory. Especifique uma instância usando a seguinte sintaxe: NameSpace:Class[N].Property onde [N] é o número da instância. Por exemplo, root\cimv2:Win32_OnboardDevice[3].Description. 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, ((#variable1# + #variable2#) + 17.4) / (#variable3# * 4). As variáveis de procedimento deverão conter valores numéricos.
  • 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.
• Variáveis de alerta: um procedimento de agente pode ser atribuído para executar quando um alerta é acionado. Na maioria dos casos, o alerta passa variáveis predefinidas para o procedimento de agente. Essas variáveis de alerta são documentadas pelo tópico de alerta. Consulte Alertas - Novo agente instalado, por exemplo.
• Variáveis de ambiente do Windows: é possível referenciar variáveis de ambiente do Windows somente com executeFile(), Executar arquivo no caminho e executeShellCommand(). Coloque o comando entre aspas, pois a variável de ambiente pode conter espaços que podem afetar sua execução. Para outros comandos de procedimento de agente, use getVariable() para obter a chave de registro que contém as variáveis de ambiente, localizadas em HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment.