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>]
Description
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
