建立新別名。

語法

New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

New-Alias Cmdlet 會在目前的 Windows PowerShell 工作階段中建立新的別名。使用 New-Alias 建立的別名不會在結束工作階段或關閉 Windows PowerShell 之後儲存。您可以使用 Export-Alias Cmdlet，將別名資訊儲存到檔案。稍後則可以使用 Import-Alias 來擷取這項儲存的別名資訊。

參數

-Description <string>

指定別名的描述。可輸入任意字串。如果描述中包含空格，請將其置於引號內。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Force

如果設定此參數，其作用就像在別名名稱已存在的情況下執行 Set-Alias 一樣。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Name <string>

指定新別名。別名可使用任意英數字元，但第一個字元不可以是數字。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Option <ScopedItemOptions>

設定別名的一或多個選擇性屬性。有效的值包括：

-- None：不設定選項。(預設值)。

-- ReadOnly：無法變更別名，除非使用 Force 參數。

-- Constant：無法變更別名，即便使用 Force 參數也一樣。

-- Private：別名僅可在 Scope 參數所指定的範圍內使用。在其餘所有範圍內，別名均為不可見。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-PassThru

傳回代表新別名的物件。根據預設，此 Cmdlet 不會產生任何輸出。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Scope <string>

指定新別名的範圍。有效的值包括 "Global"、"Local"、"Script" 或相對於目前範圍的數字 (從 0 到範圍總數，其中 0 代表目前範圍，1 代表其上層)。預設值為 "Local"。如需詳細資訊，請參閱 about_Scopes。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Value <string>

指定要建立別名的 cmdlet 或命令元素的名稱。

必要?

true

位置?

2

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

無

您無法經由管道將輸入輸出至這個 Cmdlet。

輸出

None 或 System.Management.Automation.AliasInfo

如果使用 Passthru 參數，New-Alias 會產生代表新別名的 System.Management.Automation.AliasInfo 物件，否則，這個 Cmdlet 不會產生任何輸出。

附註

若要建立新的別名，請使用 Set-Alias 或 New-Alias。若要變更別名，請使用 Set-Alias。若要刪除別名，請使用 Remove-Item。

範例 1

C:\PS>new-alias list get-childitem

描述
-----------
這個命令會建立名為 "list" 的別名來代表 Get-ChildItem Cmdlet。

範例 2

C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly

C:\PS> get-alias -name w | format-list *

描述
-----------
這個命令會建立名為 "w" 的別名來代表 Get-WMIObject Cmdlet。它建立別名的描述 "quick wmi alias"，並將其設定為唯讀。最後一行命令使用 Get-Alias 來取得新別名，並經由管道將它輸出至 Format-List 以顯示所有的相關資訊。

請參閱



目錄