New-Alias

模組:
Microsoft.PowerShell.Utility Module

建立一個新的別名。

語法

Default (預設值) 

New-Alias
    [-Name] <String>
    [-Value] <String>
    [-Description <String>]
    [-Option <ScopedItemOptions>]
    [-PassThru]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-Alias這個 cmdlet 會在目前的 PowerShell 會話中建立一個新的別名。 使用該系統 New-Alias 建立的別名在你退出會話或關閉 PowerShell 後不會被儲存。 你可以用 Export-Alias cmdlet 把別名資訊存到檔案裡。 你之後 Import-Alias 可以用來取回那些儲存的別名資訊。

範例

範例 1：為 cmdlet 建立別名

New-Alias -Name "List" Get-ChildItem

此指令會建立一個名為 List 的別名，以代表 Get-ChildItem cmdlet。

範例 2：為 cmdlet 建立唯讀別名

此指令會建立一個名為 C cmdlet 的別名。Get-ChildItem 它會為該別名建立「快速 gci 別名」的描述，並設為唯讀。

New-Alias -Name "C" -Value Get-ChildItem -Description "Quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : Quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

Get-Alias輸入Format-List的指令會顯示所有關於新別名的資訊。

範例 3：為帶有參數的指令建立別名

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

第一個指令建立函式 Set-ParentDirectory，用來 Set-Location 將工作位置設定為父目錄。 第二個指令用於 New-Alias 建立別名 來 .. 呼叫該 Set-ParentDirectory 函式。 由於 Value 參數需要 cmdlet、function 或可執行值，你必須建立一個自訂函式來建立使用參數的別名。 執行別名 .. 會將當前位置改為父目錄。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Description

指定別名的描述。 你可以輸入任何字串。 如果描述包含空格，請用引號包圍。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

表示 cmdlet 的行為就像 Set-Alias 該別名已經存在時一樣。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定新別名。 你可以在別名中使用任何字母數字，但第一個字元不能是數字。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Option

指定別名的 Options 屬性值。 有效值為：

  • None：別名沒有條件約束（預設值）
  • ReadOnly：別名可以刪除，但除非使用 力 場參數
  • Constant：該別名無法刪除或更改
  • Private：別名只能在目前的範圍內使用
  • AllScope：別名會自動複製到任何新建立的範圍中
  • Unspecified：未指定選項

這些值會定義為旗標型列舉。 您可以將多個值結合在一起，以使用此參數來設定多個旗標。 這些值可以以數值陣列的形式傳遞給 Option 參數，或以逗號分隔的數值串形式傳遞。 Cmdlet 會使用二進位 OR 作業來合併值。 將值以陣列的形式傳遞是最簡單的選擇，還可以讓您在使用 Tab 鍵時自動完成值。

要查看會話中所有別名的 選項 屬性，請輸入 Get-Alias | Format-Table -Property Name, Options -AutoSize。

參數屬性

類型:ScopedItemOptions
預設值:[System.Management.Automation.ScopedItemOptions]::None
接受的值:None, ReadOnly, Constant, Private, AllScope, Unspecified
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PassThru

返回一個物件，代表您正在處理的項目。 根據預設，此 Cmdlet 不會產生任何輸出。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Scope

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

  • Global
  • Local
  • Script
  • 相對於目前範圍的數字（0 除以範圍數，其中 0 是當前範圍，是 1 其父範圍）。

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Value

指定被別名化的指令小程式或指令元素名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值: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。

輸入

None

您不能將物件透過管道傳送到此 Cmdlet。

輸出

None

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

AliasInfo

當你使用 PassThru 參數時，這個 cmdlet 會回傳一個代表新別名的 AliasInfo 物件。

備註

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

  • 所有平臺：

    • nal

  • 要建立新別名，請使用 Set-Alias 或 New-Alias。 要更改別名，請使用 Set-Alias. 要刪除別名，請使用 Remove-Alias.