New-Variable
Cria uma nova variável.
New-Variable
[-Name] <String>
[[-Value] <Object>]
[-Description <String>]
[-Option <ScopedItemOptions>]
[-Visibility <SessionStateEntryVisibility>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
O New-Variable
cmdlet cria uma nova variável no PowerShell. Você pode atribuir um valor à variável ao criá-la ou atribuir ou alterar o valor depois que ela é criada.
Você pode usar os parâmetros de New-Variable
para definir as propriedades da variável, definir o escopo de uma variável e determinar se as variáveis são públicas ou privadas.
Normalmente, você cria uma nova variável digitando o nome da variável e seu valor, como $Var = 3
, mas pode usar o New-Variable
cmdlet para usar seus parâmetros.
New-Variable days
Este comando cria uma nova variável chamada days. Não é necessário digitar o parâmetro Name .
New-Variable -Name "zipcode" -Value 98033
Este comando cria uma variável chamada zipcode e atribui-lhe o valor 98033.
PS C:\> New-Variable -Name Max -Value 256 -Option ReadOnly
PS C:\> New-Variable -Name max -Value 1024
New-Variable : A variable with name 'max' already exists.
At line:1 char:1
+ New-Variable -Name max -Value 1024
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ResourceExists: (max:String) [New-Variable], SessionStateException
+ FullyQualifiedErrorId : VariableAlreadyExists,Microsoft.PowerShell.Commands.NewVariableCommand
PS C:\> New-Variable -Name max -Value 1024 -Force
Este exemplo mostra como usar a ReadOnly
opção de New-Variable
para proteger uma variável de ser substituída.
O primeiro comando cria uma nova variável chamada Max e define seu valor como 256. Ele usa o parâmetro Option com um valor de ReadOnly
.
O segundo comando tenta criar uma segunda variável com o mesmo nome. Este comando retorna um erro, porque a opção somente leitura está definida na variável.
O terceiro comando usa o parâmetro Force para substituir a proteção somente leitura na variável. Nesse caso, o comando para criar uma nova variável com o mesmo nome é bem-sucedido.
New-Variable -Name 'TestVariable' -Value 'Test Value' -Option AllScope,Constant
Este exemplo cria uma variável e atribui as AllScope
opções e Constant
para que a variável esteja disponível no escopo atual e quaisquer novos escopos criados e não possam ser alterados ou excluídos.
Este comando demonstra o comportamento de uma variável privada em um módulo. O módulo contém o Get-Counter
cmdlet, que tem uma variável privada chamada Counter. O comando usa o parâmetro Visibility com um valor Private para criar a variável.
PS C:\> New-Variable -Name counter -Visibility Private
#Effect of private variable in a module.
PS C:\> Get-Variable c*
Name Value
---- -----
Culture en-US
ConsoleFileName
ConfirmPreference High
CommandLineParameters {}
PS C:\> $counter
"Cannot access the variable '$counter' because it is a private variable"
At line:1 char:1
+ $counter
+ ~~~~~~~~
+ CategoryInfo : PermissionDenied: (counter:String) [], SessionStateException
+ FullyQualifiedErrorId : VariableIsPrivate
PS C:\> Get-Counter
Name Value
---- -----
Counter1 3.1415
...
A saída de amostra mostra o comportamento de uma variável privada. O usuário que carregou o módulo não pode visualizar ou alterar o valor da variável Contador, mas a variável Contador pode ser lida e alterada pelos comandos no módulo.
Este exemplo demonstra que variáveis com espaços podem ser criadas. As variáveis podem ser acessadas usando o Get-Variable
cmdlet ou diretamente delimitando uma variável com chaves.
PS C:\> New-Variable -Name 'with space' -Value 'abc123xyz'
PS C:\> Get-Variable -Name 'with space'
Name Value
---- -----
with space abc123xyz
PS C:\> ${with space}
abc123xyz
Solicita a sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica uma descrição da variável.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Indica que o cmdlet cria uma variável com o mesmo nome de uma variável somente leitura existente.
Por padrão, você pode substituir uma variável, a menos que a variável tenha um valor de opção de ReadOnly
ou Constant
. Para obter mais informações, consulte o parâmetro Option .
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica um nome para a nova variável.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica o valor da propriedade Options da variável. Os valores aceitáveis para este parâmetro são:
None
- Não define opções.None
é a predefinição.ReadOnly
- Pode ser excluído. Não pode ser alterado, exceto usando o parâmetro Force .Private
- A variável está disponível apenas no âmbito atual.AllScope
- A variável é copiada para quaisquer novos escopos que são criados.Constant
- Não pode ser excluído ou alterado.Constant
é válido somente quando você está criando uma variável. Não é possível alterar as opções de uma variável existente paraConstant
.
Esses valores são definidos como uma enumeração baseada em sinalizador. Você pode combinar vários valores juntos para definir vários sinalizadores usando esse parâmetro. Os valores podem ser passados para o parâmetro Option como uma matriz de valores ou como uma cadeia de caracteres separada por vírgulas desses valores. O cmdlet combinará os valores usando uma operação binary-OR. Passar valores como uma matriz é a opção mais simples e também permite que você use o preenchimento de tabulação nos valores.
Para ver a propriedade Options de todas as variáveis na sessão, digite Get-Variable | Format-Table -Property name, options -AutoSize
.
Tipo: | ScopedItemOptions |
Valores aceites: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica o escopo da nova variável. Os valores aceitáveis para este parâmetro são:
Global
- As variáveis criadas no escopo global são acessíveis em todos os lugares em um processo do PowerShell.Local
- O âmbito local refere-se ao âmbito atual, este pode ser qualquer âmbito dependendo do contexto.Local
é o escopo padrão quando o parâmetro scope não é especificado.Script
- As variáveis criadas no escopo do script são acessíveis apenas dentro do arquivo de script ou módulo em que são criadas.- Um número relativo ao escopo atual (0 através do número de escopos, onde 0 é o escopo atual, 1 é seu pai, 2 o pai do escopo pai e assim por diante). Números negativos não podem ser usados.
Nota
O parâmetro também aceita o valor de Private
. Private
na verdade, não é um escopo, mas uma configuração opcional para uma variável. No entanto, usar o Private
valor com esse cmdlet não altera a visibilidade da variável. Para obter mais informações, consulte about_Scopes.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica o valor inicial da variável.
Tipo: | Object |
Position: | 1 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Determina se a variável é visível fora da sessão em que foi criada. Este parâmetro foi projetado para uso em scripts e comandos que serão entregues a outros usuários. Os valores aceitáveis para este parâmetro são:
Public
- A variável é visível.Public
é a predefinição.Private
- A variável não é visível.
Quando uma variável é privada, ela não aparece em listas de variáveis, como as retornadas pela Get-Variable
, ou em exibições da Variable:
unidade. Os comandos para ler ou alterar o valor de uma variável privada retornam um erro. No entanto, o usuário pode executar comandos que usam uma variável privada se os comandos foram escritos na sessão em que a variável foi definida.
Tipo: | SessionStateEntryVisibility |
Valores aceites: | Public, Private |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Você pode canalizar qualquer objeto para New-Variable
.
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto PSVariable que representa a nova variável.
O PowerShell inclui os seguintes aliases para New-Variable
:
- Todas as plataformas:
nv
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: