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