Compartilhar via


about_Variables

TÓPICO
    about_Variables

DESCRIÇÃO RESUMIDA
    Descreve como as variáveis armazenam valores que podem ser usados 
    no Windows PowerShell.  

DESCRIÇÃO LONGA
    Uma variável é uma unidade de memória na qual são armazenados 
    valores. No Windows PowerShell, as variáveis são representadas 
    por cadeias de texto de uma só palavra iniciadas por cifrão ($), 
    como $a, $process ou $my_var.

    Há vários tipos diferentes de variáveis no Windows PowerShell.

    -- Variáveis criadas pelo usuário: são criadas e mantidas pelo 
       usuário. Por padrão, as variáveis que você cria na linha de 
       comando do Windows PowerShell só existem enquanto a janela do 
       Windows PowerShell está aberta e são perdidas quando você 
       fecha a janela.
       Para salvar uma variável, adicione-a ao seu perfil do Windows 
       PowerShell. Você também pode criar variáveis em scripts com 
       escopo global, de script ou local.  

    -- Variáveis automáticas: armazenam o estado do Windows 
       PowerShell. São criadas pelo Windows PowerShell, que altera 
       seus valores conforme necessário para manter sua precisão. Os 
       usuários não podem alterar o valor dessas variáveis.
       Por exemplo, a variável $PSHome armazena o caminho para o 
       diretório de instalação do Windows PowerShell. Para obter mais 
       informações, uma lista e uma descrição das variáveis 
       automáticas, consulte about_Automatic_Variables.

    -- Variáveis preferenciais: armazenam preferências do usuário 
       para o Windows PowerShell. Essas variáveis são criadas pelo 
       Windows PowerShell e preenchidas com valores padrão. Os 
       usuários podem alterar os valores dessas variáveis. Por exemplo, 
       MaximumHistoryCount determina o número máximo de entradas no 
       histórico da sessão. Para obter mais informações, uma lista e uma 
       descrição das variáveis preferenciais, consulte about_Preference_Variables.

    
 TRABALHANDO COM VARIÁVEIS

    Para listar todas as variáveis na sua sessão do Windows PowerShell, digite:

       get-variable

    Para exibir o valor de qualquer variável, digite o nome da 
    variável, precedido por um cifrão ($). O Windows PowerShell 
    responderá exibindo seu valor.

       $<nome-da-variável>

    Por exemplo:

        PS> $pshome
        C:\Windows\System32\WindowsPowerShell\v1.0


    Para criar uma nova variável ou alterar o valor de uma variável, 
    use uma instrução de atribuição no seguinte formato:

        $<variável> = <valor>

    Por exemplo:

        PS> $my-variable = 1, 2, 3

        ou

        PS> $VerbosePreference = "Continue"

    Para obter um objeto que represente a variável, use um comando 
    Get-Variable como:

        PS> get-variable pid


    Para usar uma variável, digite o nome da variável, inclusive o 
    cifrão ($), em um comando ou expressão. Se o comando ou a 
    expressão não estiver entre aspas ou se estiver entre aspas 
    duplas ("), o valor da variável será usado no comando ou na 
    expressão. Se o comando estiver entre aspas simples ('), o nome 
    da variável será usado na expressão.

    Por exemplo, o primeiro comando localiza o valor da variável 
    $profile, que é o caminho para o arquivo de perfil do usuário do 
    Windows PowerShell. O segundo comando abre o arquivo no Bloco de 
    Notas.

        PS> $profile
        C:\Documents and Settings\Usuário01\My Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1

        PS> Notepad $profile


    Você pode armazenar qualquer tipo de objeto em uma variável, 
    inclusive inteiros, cadeias de caracteres, matrizes e tabelas de 
    hash, objetos que representam processos, serviços, logs de 
    eventos e computadores.  
  

  SALVANDO VARIÁVEIS
      As variáveis criadas por você ficam disponíveis somente na 
      sessão em que foram criadas. São perdidas quando você fecha a 
      sessão.
     
      Para salvar uma variável, adicione-a ao seu perfil do Windows 
      PowerShell.
      As variáveis em um perfil serão adicionadas a todas as sessões 
      do Windows PowerShell que você abrir.

      Por exemplo, para alterar o valor da variável $VerbosePreference
      em todas as sessões do Windows PowerShell, adicione o comando 
      a seguir ao seu perfil do Windows PowerShell.

      $VerbosePreference = "Continue"

      Você pode adicionar esse comando ao seu perfil abrindo o 
      arquivo do perfil em um editor de texto como o Bloco de Notas, 
      ou então usando um comando Add-Content como o mostrado a seguir.

      O comando a seguir adiciona o novo valor para a variável 
      $VerbosePreference ao perfil CurrentUser,AllHosts.

      add-content -path $profile.CurrentUserAllHosts -value '$VerbosePreference = "Continue"'

      Para obter mais informações sobre os perfis do Windows 
      PowerShell, consulte about_profiles.


 NOMES DE VARIÁVEIS COM CARACTERES ESPECIAIS

    Você pode usar chaves para forçar o Windows PowerShell a 
    interpretar um nome de variável literalmente. Isso é 
    especialmente útil ao criar ou fazer referência a um nome de 
    variável que inclua caracteres especiais, como traços, pontos, 
    dois-pontos e parênteses. 

    Para criar um nome de variável que inclua um hífen, coloque o 
    nome da variável entre chaves. O comando a seguir cria uma 
    variável denominada "save-items".

        C:\PS> ${save-items} = "a", "b", "c"
        C:\PS>${save-items}
        a
        b
        c

    Para fazer referência a um nome de variável que inclua 
    parênteses, coloque o nome da variável entre chaves. 

    Por exemplo, o comando a seguir obtém os itens filho nos 
    repositórios de diretório da variável de ambiente "ProgramFiles(x86)".

        C:\PS> Get-childitem ${env:ProgramFiles(x86)}


    Para fazer referência a um nome de variável que inclua chaves, 
    coloque o nome da variável entre chaves e use o caractere de 
    crase (escape) para sair das chaves. Por exemplo, para criar uma 
    variável denominada "this{value}is" com valor 1, digite: 

        C:\PS> ${this`{value`}is} = 1
        C:\PS> ${this`{value`}is}
        1


 A UNIDADE VARIABLE:

     O Windows PowerShell inclui uma unidade Variable: que se 
     assemelha e atua como uma unidade do sistema de arquivos, mas 
     contém as variáveis da sua sessão. 

     Para alternar para a unidade Variable, digite:

        set-location variable:
        
         (ou "cd variable:")

     
     Na unidade Variable, para listar os itens (variáveis) na 
     unidade, use o cmdlet Get-ChildItem. Por exemplo:

         get-childitem

         (ou "dir" ou "ls")
     
     Para obter mais informações sobre a unidade Variable: e o 
     provedor Variable do Windows PowerShell, digite:

         get-help variable


CONSULTE TAMBÉM
    about_Automatic_Variables
    about_Environment_Variables
    about_Preference_Variables
    about_Scopes