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