共用方式為

Import-Alias

  • 參考
模組:
Microsoft.PowerShell.Utility

從檔案匯入別名清單。

語法

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

允許 Cmdlet 匯入已定義或唯讀的別名。 您可以使用下列命令來顯示目前定義別名的相關信息：

Get-Alias | Select-Object Name, Options

如果對應的別名是唯讀的，則會顯示在 Options 屬性的值中。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LiteralPath

指定檔案的路徑，其中包含導出的別名資訊。 不同於 Path 參數，LiteralPath 參數的值會與輸入時完全相同。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元，請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。

類型:String
別名:PSPath
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PassThru

會傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定檔案的路徑，其中包含導出的別名資訊。 允許通配符，但必須解析為單一名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Scope

指定匯入別名的範圍。 此參數可接受的值為：

  • 全球
  • 當地
  • 腳本
  • 相對於目前範圍的數位（0 到範圍的數目，其中0是目前的範圍，1是其父系）

預設值為Local。 如需詳細資訊，請參閱 about_Scopes。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

您可以使用管線將包含路徑的字串傳送至 Import-Alias。

輸出

None or System.Management.Automation.AliasInfo

當您使用 Passthru 參數時，Import-Alias 會傳回代表別名的 System.Management.Automation.AliasInfo 物件。 否則，此 Cmdlet 不會產生任何輸出。