Import-Alias

参考

模块:: Microsoft.PowerShell.Utility

从文件导入别名列表。

语法

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

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
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

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

Get-Alias | Select-Object Name, Options

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LiteralPath

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

类型:	String
别名:	PSPath, LP
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PassThru

返回一个对象，该对象表示正在使用的项。默认情况下，此 cmdlet 不生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

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

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-Scope

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

全球
当地
脚本
相对于当前范围的数字（0 到范围的数目，其中 0 是当前范围，1 是它的父范围）

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

可以通过管道传递包含 Import-Alias路径的字符串。

输出

None or System.Management.Automation.AliasInfo

使用 Passthru 参数时，Import-Alias 返回表示别名的 System.Management.Automation.AliasInfo 对象。否则，此 cmdlet 不会生成任何输出。

通过