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 |
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 |
输入
可以通过管道将包含路径的字符串传递给 Import-Alias
。
输出
None or System.Management.Automation.AliasInfo
使用 Passthru 参数时, Import-Alias
返回一个代表别名的 System.Management.Automation.AliasInfo 对象。
否则,此 cmdlet 将不生成任何输出。