Import-Alias

从文件导入别名列表。

语法

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

说明

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

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

示例

示例 1:从文件导入别名

Import-Alias test.txt

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

参数

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Get-Alias | Select-Object Name, Options

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

指定包含导出的别名信息的文件的路径。 与 Path参数不同,LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

返回一个代表你所处理的项目的对象。 默认情况下,此 cmdlet 将不产生任何输出。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

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

  • 全球
  • Local
  • 脚本
  • 一个相对于当前作用域的数字(0 到作用域数,其中 0 是指当前作用域,1 是指其父作用域)

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

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

输出

None or System.Management.Automation.AliasInfo

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