Compartilhar via

New-Alias

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Cria um novo alias.

Sintaxe

New-Alias
   [-Name] <String>
   [-Value] <String>
   [-Description <String>]
   [-Option <ScopedItemOptions>]
   [-PassThru]
   [-Scope <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-Alias cria um novo alias na sessão atual do Windows PowerShell. Os aliases criados usando New-Alias não são salvos após você sair da sessão ou fechar o Windows PowerShell. Você pode usar o cmdlet Export-Alias para salvar suas informações de alias em um arquivo. Posteriormente, você pode usar Import-Alias para recuperar essas informações de alias salvas.

Exemplos

Exemplo 1: criar um alias para um cmdlet

PS C:\> New-Alias -Name "List" Get-ChildItem

Esse comando cria um alias chamado Lista para representar o cmdlet Get-ChildItem.

Exemplo 2: criar um alias somente leitura para um cmdlet

PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *

Esse comando cria um alias chamado W para representar o cmdlet Get-WmiObject. Ele cria uma descrição, alias wmi rápido, para o alias e o torna somente leitura. A última linha do comando usa Get-Alias para obter o novo alias e redirecioná-lo para Format-List para exibir todas as informações sobre ele.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição do alias. Você pode digitar qualquer cadeia de caracteres. Se a descrição incluir espaços, coloque-a entre aspas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que o cmdlet age como Set-Alias se o alias nomeado já existir.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o novo alias. Você pode usar caracteres alfanuméricos em um alias, mas o primeiro caractere não pode ser um número.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Option

Especifica o valor da propriedade Options do alias. Os valores válidos são:

  • Nenhum: o alias não tem restrições (valor padrão)
  • ReadOnly: O alias pode ser excluído, mas não pode ser alterado, exceto usando o parâmetro Force
  • Constante: o alias não pode ser excluído ou alterado
  • Privado: o alias só está disponível no escopo atual
  • AllScope: o alias é copiado para quaisquer novos escopos criados
  • Não especificado: a opção não é especificada

Para ver a propriedade Options de todos os aliases na sessão, digite Get-Alias | Format-Table -Property Name, Options -AutoSize.

Tipo:ScopedItemOptions
Valores aceitos:None, ReadOnly, Constant, Private, AllScope, Unspecified
Cargo:Named
Valor padrão:[System.Management.Automation.ScopedItemOptions]::None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Scope

Especifica o escopo do novo alias. Os valores aceitáveis para este parâmetro são:

  • Global
  • Local
  • Roteiro
  • Um número relativo ao escopo atual (0 por meio do número de escopos, em que 0 é o escopo atual e 1 é o pai).

Local é o padrão. Para obter mais informações, consulte about_Scopes.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Value

Especifica o nome do cmdlet ou do elemento de comando que está sendo aliased.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Não é possível redirecionar a entrada para este cmdlet.

Saídas

None or System.Management.Automation.AliasInfo

Quando você usa o parâmetro Passthru, New-Alias gera um objeto System.Management.Automation.AliasInfo que representa o novo alias. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

  • Para criar um novo alias, use Set-Alias ou New-Alias. Para alterar um alias, use Set-Alias. Para excluir um alias, use Remove-Item.