Import-Alias
從檔案匯入別名清單。
語法
Import-Alias [-Path] <string> [-Force] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
描述
Import-Alias Cmdlet 會從檔案匯入別名清單。
參數
-Force
允許此 Cmdlet 匯入已定義的唯讀別名。使用下列命令可顯示目前已定義別名的相關資訊：
get-alias | Select-Object name,Options
如果對應的別名為唯讀，則 Options 屬性值將包含 "ReadOnly"。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-PassThru
傳回代表別名的物件。根據預設，此 Cmdlet 不會產生任何輸出。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Path <string>
指定匯出別名資訊的檔案所在路徑。允許使用萬用字元，但解析結果必須是單一名稱。
必要? |
true |
位置? |
1 |
預設值 |
|
接受管線輸入? |
true (ByValue, ByPropertyName) |
接受萬用字元? |
false |
-Scope <string>
指定匯入別名的目標範圍。有效的值包括 "Global"、"Local"、"Script" 或相對於目前範圍的數字 (從 0 到範圍總數，其中 0 代表目前範圍，1 代表其上層)。預設值為 "Local"。如需詳細資訊，請參閱 about_Scopes。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Confirm
在執行命令前先提示確認。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-WhatIf
說明執行命令時將會發生何種情況，但不會實際執行命令。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.String 您可經由管道將包含路徑的字串輸出至 Import-Alias。 |
輸出 |
無或 System.Management.Automation.AliasInfo 當您使用 Passthru 參數時，Import-Alias 會傳回代表別名的 System.Management.Automation.AliasInfo 物件，否則，這個 Cmdlet 不會產生任何輸出。 |
範例 1
C:\PS>import-alias test.txt
描述
-----------
這個命令會從名為 test.txt 的檔案匯入別名資訊。