Share via

New-Alias

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

新しいエイリアスを作成します。

構文

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

説明

コマンドレットは New-Alias 、現在の PowerShell セッションに新しいエイリアスを作成します。 を使用 New-Alias して作成されたエイリアスは、セッションを終了した後、または PowerShell を閉じると保存されません。 コマンドレットを Export-Alias 使用して、エイリアス情報をファイルに保存できます。 後で を使用 Import-Alias して、保存されたエイリアス情報を取得できます。

例

例 1: コマンドレットのエイリアスをCreateする

New-Alias -Name "List" Get-ChildItem

このコマンドは、Get-ChildItem コマンドレットを表す List という名前のエイリアスを作成します。

例 2: コマンドレットの読み取り専用エイリアスをCreateする

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

このコマンドは、 コマンドレットを表す という名前 C のエイリアスを Get-ChildItem 作成します。 エイリアスの 説明 を作成し、 quick gci alias読み取り専用にします。 コマンドの最後の行では、 を使用 Get-Alias して新しいエイリアスを取得し、それに関するすべての情報を表示するために Format-List にパイプします。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

という名前のエイリアスが既に存在する場合、コマンドレットがのように 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 パラメーターに渡すことができます。 コマンドレットは、バイナリ OR 操作を使用して値を結合します。 配列として値を渡すことは最も簡単なオプションであり、値にタブ補完を使用することもできます。

セッション内のすべてのエイリアスの 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

作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

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

エイリアスを作成するコマンドレットまたはコマンド要素の名前を指定します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

オブジェクトをこのコマンドレットにパイプすることはできません。

出力

None

既定では、このコマンドレットは出力を返しません。

AliasInfo

PassThru パラメーターを使用すると、このコマンドレットは新しいエイリアスを表す AliasInfo オブジェクトを返します。

メモ

PowerShell には、 の次のエイリアスが New-Alias含まれています。

  • すべてのプラットフォーム:

    • nal

  • 新しいエイリアスを作成するには、 または を使用 Set-Alias します New-Alias。 エイリアスを変更するには、 を使用します Set-Alias。 エイリアスを削除するには、 を使用します Remove-Alias。