共用方式為

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