Import-Alias

  • 參考
模組:
Microsoft.PowerShell.Utility

從檔案匯入別名清單。

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

輸入

String

您可以使用管線傳送包含此 Cmdlet 路徑的字串。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

AliasInfo

當您使用 PassThru 參數時，這個 Cmdlet 會 傳回代表別名的 AliasInfo 物件。

備註

PowerShell 包含下列的 Import-Alias別名：

  • 所有平臺：
    • ipal