Get-Alias

项目
10/30/2009

获取当前会话的别名。

语法

Get-Alias [[-Name] <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

说明

Get-Alias cmdlet 获取当前会话的别名（命令和可执行文件的替代名称）。其中包括内置别名、已设置或导入的别名，以及已添加到 Windows PowerShell 配置文件中的别名。

默认情况下，Get-Alias 获取别名并返回命令名称。当使用 Definition 参数时，Get-Alias 采用命令名称并返回其别名。

参数

-Definition <string[]>

获取所指定项的别名。请输入 cmdlet、函数、脚本、文件或可执行文件的名称。

此参数名为 Definition，这是因为它在别名对象的 Definition 属性中搜索项目名称。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	true

-Exclude <string[]>

忽略指定项。此参数的值对 Name 和 Definition 参数进行限定。请输入名称、定义或模式，例如“s*”。允许使用通配符。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	false

-Name <string[]>

指定要检索的别名。允许使用通配符。默认情况下，Get-Alias 将检索为当前会话定义的所有别名。参数名（“Name”）为可选项。还可通过管道将别名传递至 Get-Alias。

是否为必需？	false
位置？	1
默认值
是否接受管道输入？	true (ByValue, ByPropertyName)
是否接受通配符？	false

-Scope <string>

仅获取所指定作用域中的别名。有效值包括“Global”、“Local”、“Script”或者相对于当前作用域的数字（0 到作用域数，其中 0 是指当前作用域，1 是指其父作用域）。默认值为“Local”。有关详细信息，请参阅 about_Scopes。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

System.String

还可通过管道将别名传递至 Get-Alias。

输出

System.Management.Automation.AliasInfo

Get-Alias 返回表示每个别名的对象。

说明

别名是 cmdlet、函数或可执行文件的替代名称或昵称。若要运行 cmdlet、函数或可执行文件，则可使用其全名或任何别名。有关详细信息，请参阅 about_Aliases。

若要创建新别名，请使用 Set-Alias 或 New-Alias。若要删除别名，请使用 Remove-Item。

示例 1

C:\PS>get-alias

说明
-----------
此命令获取当前会话中的所有别名。

示例 2

C:\PS>get-alias -name g*, s* -exclude get-*

说明
-----------
此命令获取所有以“g”或“s”开头的别名，但以“get-”开头的别名除外。

示例 3

C:\PS>get-alias -definition Get-ChildItem

说明
-----------
此命令获取 Get-ChildItem cmdlet 的别名。

默认情况下，Get-Alias cmdlet 会在您知道别名的情况下获取项目名称。Definition 参数会在您知道项目名称的情况下获取别名。

示例 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

说明
-----------
此命令将检索所有其 Options 属性值为 ReadOnly 的别名。此命令提供了快速查找 Windows PowerShell 中内置别名的方法，因为这些别名均具有 ReadOnly 选项。

Options 属性仅是 Get-Alias 获取的 AliasInfo 对象的属性之一。若要查找 AliasInfo 对象的所有属性和方法，请键入“get-alias | get-member”。

示例 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

说明
-----------
此示例获取所有以“-pssession”结尾的命令别名，但以“e”开头的别名除外。

该命令使用 Scope 参数将命令应用到全局作用域。当您希望获取会话中的别名时，这对脚本比较有用。

另请参阅

概念

about_aliases
Set-Alias
New-Alias
Export-Alias
Import-Alias
Alias Provider

通过