Share via


Aliases de cmdlet

Você pode usar aliases de cmdlet para melhorar a experiência do usuário do cmdlet. Você pode adicionar aliases a cmdlets usados com frequência para reduzir a digitação e facilitar a conclusão das tarefas rapidamente. Você pode incluir aliases internos em seus cmdlets ou os usuários podem definir seus próprios aliases personalizados.

Por exemplo, o cmdlet Get-Command tem um gcm alias interno. Você também pode usar aliases para adicionar nomes de comando de outros idiomas para que os usuários não precisem aprender novos comandos.

Diretrizes de alias

Siga estas diretrizes ao criar aliases internos para seus cmdlets:

  • antes de atribuir aliases, inicie Windows PowerShell e, em seguida, execute o cmdlet Get-Alias para ver os aliases que já foram usados.

  • Inclua um prefixo de alias que referencie o verbo do nome do cmdlet e um sufixo de alias que referencie o substantivo do nome do cmdlet. Por exemplo, o alias para o Import-Module cmdlet é ipmo . Para obter uma lista de todos os verbos e seus aliases, consulte verbos de cmdlet.

  • Para os cmdlets que têm o mesmo verbo, inclua o mesmo prefixo de alias. por exemplo, os aliases para todos os cmdlets Windows PowerShell que têm o verbo "Get" em seu nome usam o prefixo "g".

  • Para os cmdlets que têm o mesmo substantivo, inclua o mesmo sufixo de alias. por exemplo, os aliases para todos os cmdlets Windows PowerShell que têm o substantivo "Session" em seu nome usam o sufixo "sn".

  • Para cmdlets equivalentes a comandos em outros idiomas, use o nome do comando.

  • Em geral, torne os aliases o mais curto possível. Verifique se o alias tem pelo menos um caractere distinto para o verbo e um caractere distinto para o substantivo. Adicione mais caracteres conforme necessário para tornar o alias exclusivo.

  • Para o cmdlet escrito em C# (ou qualquer outra linguagem .NET compilada), o alias pode ser definido usando o alias atributo. Por exemplo:

    [Cmdlet("Get", "SomeObject")]
    [Alias("gso")]
    public class GetSomeObjectCommand : Cmdlet
    

Consulte Também

Escrevendo um Cmdlet do Windows PowerShell