Import-Alias
匯入來自檔案的別名清單。
Syntax
Import-Alias
[-Path] <String>
[-Scope <String>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Import-Alias
-LiteralPath <String>
[-Scope <String>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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
指定要匯入別名的範圍。 此參數可接受的值為:
- 全球
- 本機
- 指令碼
- 相對於目前範圍的數字 (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 不會產生任何輸出。