New-Alias
建立新的別名。
Syntax
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
New-Alias Cmdlet 會在目前的 PowerShell 會話中建立新的別名。 結束會話或關閉 PowerShell 之後，不會儲存使用 New-Alias 建立的別名。 您可以使用 Export-Alias Cmdlet 將別名資訊儲存到檔案。 您之後可以使用 Import-Alias 來抓取儲存的別名資訊。
範例
範例 1︰建立 Cmdlet 的別名
PS C:\> New-Alias -Name "List" Get-ChildItem此命令會建立名為 List 的別名，以代表 Get-ChildItem Cmdlet。
範例 2︰建立 Cmdlet 的唯讀別名
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *此命令會建立名為 W 的別名，以代表 Get-WmiObject Cmdlet。 它會為別名建立描述 quick wmi alias，並使其變成唯讀。 命令的最後一行使用 Get-Alias 取得新的別名，並使用管線將它傳送至 Format-List 以顯示其所有的相關資訊。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定別名的描述。 您可以輸入任何字串。 如果描述包含空格，請將它括在引號中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
指出如果所命名的別名已經存在，此 Cmdlet 的運作方式就和 Set-Alias 一樣。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定新的別名。 您可以在別名中使用任何英數字元，但是第一個字元不能是數字。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Option
指定別名的 Options 屬性值。 有效值為：
- 無：別名沒有 (預設值)
- ReadOnly：可以使用 Force 參數來刪除別名，但無法變更
- 常數：無法刪除或變更別名
- 私用：別名僅適用於目前的範圍
- AllScope：別名會複製到任何已建立的新範圍
- 未指定：未指定選項
若要檢視工作階段中所有別名的 Options 屬性，請輸入 Get-Alias | Format-Table -Property Name, Options -AutoSize。
| Type: | ScopedItemOptions |
| Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| Position: | Named |
| Default value: | [System.Management.Automation.ScopedItemOptions]::None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
傳回代表您正在使用之項目的物件。 根據預設，此 Cmdlet 不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Scope
指定新別名的範圍。 此參數可接受的值為：
- 全球
- 本機
- 指令碼
- 相對於目前範圍的數字 (0 至範圍數目，0 為目前範圍，1 為其父系)。
Local 為預設值。 如需詳細資訊，請參閱 about_Scopes。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Value
指定 Cmdlet 名稱或已有別名的命令元素。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
輸入
None
您無法使用管線傳送輸入至此 Cmdlet。
輸出
None or System.Management.Automation.AliasInfo
使用 Passthru 參數時，New-Alias 會產生代表新別名的 System.Management.Automation.AliasInfo 物件。 否則，此 Cmdlet 不會產生任何輸出。
備註
- 若要建立新的別名，請使用
Set-Alias或New-Alias。 若要變更別名，請使用Set-Alias。 若要刪除別名，請使用Remove-Item。