Set-Alias

模組:

Microsoft.PowerShell.Utility Module

在目前的PowerShell會話中建立或變更 Cmdlet 或其他命令的別名。

語法

Default (預設值)

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

Description

Set-Alias Cmdlet 會建立或變更 Cmdlet 或命令的別名，例如函式、腳本、檔案或其他可執行檔。 別名是參考 Cmdlet 或命令的替代名稱。 例如，sal 是 Set-Alias Cmdlet 的別名。 如需詳細資訊，請參閱 about_Aliases。

Cmdlet 可以有多個別名，但別名只能與一個 Cmdlet 相關聯。 您可以使用 Set-Alias 將現有的別名重新指派給另一個 Cmdlet，或變更別名的屬性，例如描述。

創建 Set-Alias 或更改的別名不是永久性的，僅在當前 PowerShell 工作階段期間可用。 關閉 PowerShell 工作階段時，會移除別名。

範例

範例 1：建立 Cmdlet 的別名

此命令會在目前的 PowerShell 工作階段中建立 Cmdlet 的別名。

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

Set-Alias Cmdlet 會在目前的 PowerShell 工作階段中建立別名。 Name 參數會指定別名的名稱，list。 Value 參數會指定別名執行的 Cmdlet。

若要執行別名，請在PowerShell命令行上輸入 list。

範例 2：將現有的別名重新指派給不同的 Cmdlet

此命令會重新指派現有的別名，以執行不同的 Cmdlet。

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

Get-Alias Cmdlet 會使用 Name 參數來顯示 list 別名。 list 別名與 Get-ChildItem Cmdlet 相關聯。 執行 list 別名時，會顯示目前目錄中的專案。

Set-Alias Cmdlet 會使用 Name 參數來指定 list 別名。 Value 參數會將別名與 Get-Location Cmdlet 產生關聯。

Get-Alias Cmdlet 會使用 Name 參數來顯示 list 別名。 list 別名與 Get-Location Cmdlet 相關聯。 執行 list 別名時，會顯示目前目錄的位置。

範例 3：建立和變更唯讀別名

此命令會建立唯讀別名。 唯讀選項可防止對別名進行非預期的變更。 若要變更或刪除唯讀別名，請使用 Force 參數。

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

Set-Alias Cmdlet 會在目前的 PowerShell 工作階段中建立別名。 Name 參數會指定別名的名稱，loc。 Value 參數會指定別名執行 Get-Location Cmdlet。 Option 參數會指定 readOnly 值。 PassThru 參數代表別名物件，並將物件向下傳送至 Format-List Cmdlet。 Format-List使用帶星號 （） 的 * 參數，以便顯示所有屬性。 範例輸出會顯示這些屬性的部分清單。

loc 別名會隨著新增兩個參數而變更。 描述 新增文字來說明別名的目的。 需要 Force 參數，因為 loc 別名是唯讀的。 如果未使用 Force 參數，則更改將失敗。

範例 4：建立可執行文件的別名

此範例會在本機計算機上建立可執行文件的別名。

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

Set-Alias Cmdlet 會在目前的 PowerShell 工作階段中建立別名。 Name 參數會指定別名的名稱，np。 Value 參數指定路徑和應用程式名稱 C:\Windows\notepad.exe。 cmdlet Get-Alias 使用 Name 參數來顯示 np 別名與 notepad.exe關聯。

要執行別名，請在 PowerShell 命令列中鍵入 np 以開啟 notepad.exe。

範例 5：使用參數建立命令的別名

此範例示範如何使用參數將別名指派給命令。

您可以建立 Cmdlet 的別名，例如 Set-Location。 無法為具有參數與值的指令建立別名，例如 Set-Location -Path C:\Windows\System32. 若要建立命令的別名，請建立包含 命令的函式，然後建立函式的別名。 如需詳細資訊，請參閱 about_Functions。

PS> Function CD32 {Set-Location -Path C:\Windows\System32}

PS> Set-Alias -Name Go -Value CD32

會建立名為 CD32 的函式。 該函數使用帶有Set-Location參數的 cmdlet 來指定目錄 C：\Windows\System32。

Set-Alias Cmdlet 會在目前的 PowerShell 工作階段中建立函式的別名。 Name 參數會指定別名的名稱，Go。 Value 參數會指定函式的名稱，CD32。

若要執行別名，請在PowerShell命令行上輸入 Go。 該 CD32 函數運行並更改為目錄 C：\Windows\System32。

參數

-Confirm

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

參數屬性

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

參數集

(All)

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

-Description

指定別名的描述。 您可以輸入任何字串。 如果描述包含空格，請用單引弧括起來。

參數屬性

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

參數集

(All)

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

-Force

使用 Force 參數來變更或刪除 Option 參數設定為 ReadOnly的別名。

Force 參數無法更改或刪除 Option 參數設置為 Constant 的別名。

參數屬性

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

參數集

(All)

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

-Name

指定新別名的名稱。 別名可以包含字母數位字元。 別名不能是數位，例如123。

參數屬性

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

參數集

(All)

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

-Option

設定別名的 Option 屬性值。 ReadOnly 和 Constant 等值可保護別名免受意外更改。 若要查看工作階段中所有別名的 Option 屬性，請輸入 Get-Alias | Format-Table -Property Name, Options -Autosize。

此參數可接受的值如下：

• 全範圍 別名將複製到創建的任何新範圍。
• 不斷 無法更改或刪除。
• 沒有 不設置任何選項，並且是預設設置。
• 私人 別名僅在當前範圍內可用。
• 唯讀 除非使用 Force 參數，否則無法更改或刪除。
• 未指定

參數屬性

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

參數集

(All)

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

-PassThru

傳回代表別名的物件。 使用格式 Cmdlet，例如 Format-List 來顯示物件。 根據預設，Set-Alias 不會產生任何輸出。

參數屬性

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

參數集

(All)

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

-Scope

指定這個別名有效的範圍。 預設值為 Local。 如需詳細資訊，請參閱 about_Scopes。

可接受的值如下：

• 全球
• 本地
• 私人
• 編號範圍
• 劇本

參數屬性

類型:	String
預設值:	Local
接受的值:	Global, Local, Private, Numbered scopes, Script
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-Value

指定別名執行之 Cmdlet 或命令的名稱。 Value 參數是別名 Definition 屬性。

參數屬性

類型:	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

Set-Alias 不接受來自管道的輸入。

輸出

None or System.Management.Automation.AliasInfo

使用 PassThru 參數時， Set-Alias 會生成一個表示別名的 System.Management.Automation.AliasInfo 物件。 否則， Set-Alias 不會生成任何輸出。

備註

PowerShell 包含每個 PowerShell 工作階段中可用的內建別名。 Get-Alias Cmdlet 會顯示 PowerShell 工作階段中可用的別名。

若要建立新的別名，請使用 Set-Alias 或 New-Alias。 若要移除別名，請使用 Remove-Item Cmdlet。 例如： Remove-Item -Path Alias:aliasname 。

要創建每個 PowerShell 工作階段中可用的別名，請將其添加到您的 PowerShell 配置檔中。 如需詳細資訊，請參閱 about_Profiles。

您可以藉由執行匯出和匯入，將別名儲存並重複使用在另一個 PowerShell 會話中。 若要將別名儲存至檔案，請使用 Export-Alias。 若要將已儲存的別名新增至新的 PowerShell 工作階段，請使用 Import-Alias。

相關連結

• 關於別名
• 關於函數 (about_Functions)
• 關於個人檔案
• 關於_Scopes
• Export-Alias
• Get-Alias
• Import-Alias
• 新別名 (New-Alias)
• 移除項目