New-Alias

  • 參考
模組:
Microsoft.PowerShell.Utility

建立新的別名。

Syntax

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

Description

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

範例

範例 1：建立 Cmdlet 的別名

New-Alias -Name "List" Get-ChildItem

此命令會建立名為 List 的別名，以代表 Get-ChildItem Cmdlet。

範例 2：建立 Cmdlet 的唯讀別名

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

此命令會建立名為 C 的別名來代表 Get-ChildItem Cmdlet。 它會建立別名的描述、快速 wmi 別名，並使它成為唯讀的。 命令的最後一行會使用 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 屬性值。 有效值為：

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

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

若要檢視工作階段中所有別名的 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

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

  • Global
  • Local
  • Script
  • 相對於目前範圍的數位（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

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

AliasInfo

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

備註

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

  • nal

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