网站搜索

Import-Alias (Microsoft.PowerShell.Utility)

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

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

-Force

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

Get-Alias | Select-Object Name, Options

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

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-LiteralPath

指定包含导出的别名信息的文件的路径。与 Path 参数不同，LiteralPath 参数的值完全按照键入的方式使用。没有字符被解释为通配符。如果路径包含转义字符，请将其用单引号引起来。单引号告诉 PowerShell 不要将任何字符解释为转义序列。

类型 ：

String

别名：

PSPath, LP

位置：

命名

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-PassThru

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

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Path

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

类型 ：

String

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

True

-Scope

指定导入别名的范围。该参数可接受的值为：

  • 全球的
  • 当地的
  • 脚本
  • 相对于当前作用域的数字（0 到作用域数量，其中 0 是当前作用域，1 是其父作用域）

默认为本地。有关详细信息，请参阅 about_Scopes。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-WhatIf

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

类型 ：

SwitchParameter

别名：

wi

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

输入

字符串

您可以通过管道传输包含此 cmdlet 路径的字符串。

输出

无

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

别名信息

当您使用 PassThru 参数时，此 cmdlet 将返回表示别名的 AliasInfo 对象。

笔记

PowerShell 包含以下 Import-Alias 别名：

  • 所有平台：

      ipal

相关文章