Partilhar via

Set-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Cria ou altera um alias para um cmdlet ou outro comando na sessão atual do PowerShell.

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet Set-Alias cria ou altera um alias para um cmdlet ou um comando, como uma função, script, arquivo ou outro executável. Um alias é um nome alternativo que se refere a um cmdlet ou comando. Por exemplo, sal é o alias do cmdlet Set-Alias. Para obter mais informações, consulte about_Aliases.

Um cmdlet pode ter vários aliases, mas um alias só pode ser associado a um cmdlet. Você pode usar Set-Alias para reatribuir um alias existente a outro cmdlet ou alterar as propriedades de um alias, como a descrição.

Um alias criado ou alterado por Set-Alias não é permanente e só está disponível durante a sessão atual do PowerShell. Quando a sessão do PowerShell é fechada, o alias é removido.

Exemplos

Exemplo 1: Criar um alias para um cmdlet

Este comando cria um alias para um cmdlet na sessão atual do PowerShell.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

O cmdlet Set-Alias cria um alias na sessão atual do PowerShell. O parâmetro Name especifica o nome do alias, list. O parâmetro Value especifica o cmdlet que o alias executa.

Para executar o alias, digite list na linha de comando do PowerShell.

Exemplo 2: Reatribuir um alias existente a um cmdlet diferente

Este comando reatribui um alias existente para executar um cmdlet diferente.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

O cmdlet Get-Alias usa o parâmetro Name para exibir o alias list. O alias list está associado ao cmdlet Get-ChildItem. Quando o alias list é executado, os itens no diretório atual são exibidos.

O cmdlet Set-Alias usa o parâmetro Name para especificar o alias list. O parâmetro Value associa o alias ao cmdlet Get-Location.

O cmdlet Get-Alias usa o parâmetro Name para exibir o alias list. O alias list está associado ao cmdlet Get-Location. Quando o alias list é executado, o local do diretório atual é exibido.

Exemplo 3: Criar e alterar um alias somente leitura

Este comando cria um alias somente leitura. A opção somente leitura impede alterações não intencionais em um alias. Para alterar ou excluir um alias somente leitura, use o parâmetro Force.

Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru |
    Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

$Parameters = @{
    Name        =  'loc'
    Value       =  (Get-Location)
    Option      =  'ReadOnly'
    Description =  'Displays the current directory'
    Force       = $true
    PassThru    = $true
}
Set-Alias @Parameters | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

O cmdlet Set-Alias cria um alias na sessão atual do PowerShell. O parâmetro Name especifica o nome do alias, loc. O parâmetro Value especifica o cmdlet Get-Location que o alias executa. O parâmetro Option especifica o valor ReadOnly. O parâmetro PassThru representa o objeto alias e envia o objeto pelo pipeline para o cmdlet Format-List. Format-List usa o parâmetro Property com um asterisco (*) para que cada propriedade seja exibida. A saída de exemplo mostra uma lista parcial dessas propriedades.

O alias loc é alterado com a adição de dois parâmetros. Descrição adiciona texto para explicar a finalidade do alias. O parâmetro Force é necessário porque o alias loc é somente leitura. Se o parâmetro Force não for usado, a alteração falhará.

Exemplo 4: Criar um alias para um arquivo executável

Este exemplo cria um alias para um arquivo executável no computador local.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

O cmdlet Set-Alias cria um alias na sessão atual do PowerShell. O parâmetro Name especifica o nome do alias, np. O parâmetro Value especifica o caminho e o nome do aplicativo C:\Windows\notepad.exe. O cmdlet Get-Alias usa o parâmetro Name para mostrar que o alias np está associado a notepad.exe.

Para executar o alias, digite np na linha de comando do PowerShell para abrinotepad.exe.

Exemplo 5: Criar um alias para um comando com parâmetros

Este exemplo mostra como atribuir um alias a um comando com parâmetros.

Você pode criar um alias para um cmdlet, como Set-Location. Não é possível criar um alias para um comando com parâmetros e valores, como Set-Location -Path C:\Windows\System32. Para criar um alias para um comando, crie uma função que inclua o comando e, em seguida, crie um alias para a função. Para obter mais informações, consulte about_Functions.

function CD32 {Set-Location -Path C:\Windows\System32}

Set-Alias -Name Go -Value CD32

Uma função chamada CD32 é criada. A função usa o cmdlet Set-Location com o parâmetro Path para especificar o diretório, C:\Windows\System32.

O cmdlet Set-Alias cria um alias para a função na sessão atual do PowerShell. O parâmetro Name especifica o nome do alias, Go. O parâmetro Value especifica o nome da função, CD32.

Para executar o alias, digite Go na linha de comando do PowerShell. A função CD32 é executada e muda para o diretório C:\Windows\System32.

Exemplo 6: Opções de atualização para um alias existente

Este exemplo mostra como atribuir várias opções usando o parâmetro Option.

Continuando do exemplo anterior, defina o alias Go como ReadOnly e Private.

Set-Alias -Name Go -Option ReadOnly, Private

O alias Go já deveria existir. Depois de executar o comando, o alias não pode ser alterado sem usar o parâmetro Force e só está disponível no escopo atual.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 simples.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

Use o parâmetro Force para alterar ou excluir um alias que tenha o parâmetro Option definido como ReadOnly.

O parâmetro Force não pode alterar ou excluir um alias com o parâmetro Option definido como Constant.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome de um novo alias. Um nome de alias pode conter caracteres alfanuméricos e hífenes. Os nomes de alias não podem ser numéricos, como 123.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Option

Define o Option valor da propriedade do alias. Valores como ReadOnly e Constant protegem um alias de alterações não intencionais. Para ver a propriedade Option de todos os aliases na sessão, digite Get-Alias | Format-Table -Property Name, Options -AutoSize.

Os valores aceitáveis para este parâmetro são os seguintes:

  • AllScope - O alias é copiado para todos os novos escopos criados.
  • Constant - Não pode ser alterado ou excluído.
  • None - Não define opções e é o padrão.
  • Private - O alias está disponível apenas no âmbito atual.
  • ReadOnly - Não pode ser alterado ou excluído a menos que o parâmetro Force seja usado.
  • Unspecified

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 combina 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.

Propriedades dos parâmetros

Tipo:ScopedItemOptions
Default value:None
Valores aceites:AllScope, Constant, None, Private, ReadOnly, Unspecified
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PassThru

Retorna um objeto que representa o alias. Use um cmdlet de formato como Format-List para exibir o objeto. Por padrão, Set-Alias não gera nenhuma saída.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Scope

Especifica o escopo no qual esse alias é válido. O valor padrão é Local. Para obter mais informações, consulte about_Scopes.

Os valores aceitáveis são os seguintes:

  • Global
  • Local
  • Private
  • Numbered scopes
  • Script

Propriedades dos parâmetros

Tipo:String
Default value:Local
Valores aceites:Global, Local, Private, Numbered scopes, Script
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Value

Especifica o nome do cmdlet ou comando que o alias executa. O parâmetro Value é a propriedade Definition do alias.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

AliasInfo

Quando você usa o parâmetro PassThru, esse cmdlet retorna um AliasInfo objeto que representa o alias.

Notas

O Windows PowerShell inclui os seguintes aliases para Set-Alias:

  • sal

O PowerShell inclui aliases internos que estão disponíveis em cada sessão do PowerShell. O cmdlet Get-Alias exibe os aliases disponíveis em uma sessão do PowerShell.

Para criar um novo alias, use Set-Alias ou New-Alias. Para remover um alias, use o cmdlet Remove-Item. Por exemplo, Remove-Item -Path Alias:aliasname.

Para criar um alias disponível em cada sessão do PowerShell, adicione-o ao seu perfil do PowerShell. Para obter mais informações, consulte about_Profiles.

Um alias pode ser salvo e reutilizado em outra sessão do PowerShell fazendo uma exportação e importação. Para salvar um alias em um arquivo, use Export-Alias. Para adicionar um alias salvo a uma nova sessão do PowerShell, use Import-Alias.