New-Alias
建立新別名。
語法
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。 |
輸出 |
無或 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 以顯示所有的相關資訊。