Import-Alias

从文件导入别名列表。

语法

ByPath (默认值)

Import-Alias
    [-Path] <String>
    [-Scope <String>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByLiteralPath

Import-Alias
    -LiteralPath <String>
    [-Scope <String>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Import-Alias cmdlet 从文件导入别名列表。

从 Windows PowerShell 3.0 开始,作为安全功能,Import-Alias 默认情况下不会覆盖现有别名。 若要覆盖现有别名,请确保别名文件的内容安全后,请使用 Force 参数。

示例

示例 1:从文件导入别名

Import-Alias test.txt

此命令从名为 test.txt的文件导入别名信息。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Force

允许 cmdlet 导入已定义或只读的别名。 可以使用以下命令显示有关当前定义的别名的信息:

Get-Alias | Select-Object Name, Options

如果相应的别名是只读的,它将显示在 Options 属性的值中。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-LiteralPath

指定包含导出别名信息的文件的路径。 与 Path 参数不同,LiteralPath 参数的值与类型化完全相同。 不会将任何字符解释为通配符。 如果路径包含转义字符,请将它括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:PSPath, LP

参数集

ByLiteralPath
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-PassThru

返回一个对象,该对象表示你正在处理的项目。 默认情况下,此 cmdlet 不生成任何输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Path

指定包含导出别名信息的文件的路径。 允许通配符,但必须解析为单个名称。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

ByPath
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Scope

指定将别名导入到的作用域。 此参数的可接受值为:

  • 全球
  • 本地
  • 剧本
  • 相对于当前范围的数字(0 到范围的数目,其中 0 是当前范围,1 是它的父范围)

默认值为 Local。 有关详细信息,请参阅 about_Scopes

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

可以通过管道将包含路径的字符串传递给此 cmdlet。

输出

None

默认情况下,此 cmdlet 不返回任何输出。

AliasInfo

使用 PassThru 参数时,此 cmdlet 返回表示别名的 AliasInfo 对象。

备注

PowerShell 包含以下与 Import-Alias相关的别名:

  • 所有平台:
    • ipal