Remove-Alias

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

現在のセッションからエイリアスを削除します。

構文

Remove-Alias
      [-Name] <String[]>
      [-Scope <String>]
      [-Force]
      [<CommonParameters>]

説明

コマンドレットは Remove-Alias 、現在の PowerShell セッションからエイリアスを削除します。 Option プロパティを ReadOnly に設定してエイリアスを削除するには、Force パラメーターを使用します。

Remove-Alias コマンドレットは、PowerShell 6.0 で導入されました。

例

例 1 - エイリアスを削除する

この例では、コマンドレットを表す名前 del のエイリアスを Remove-Item 削除します。

Remove-Alias -Name del

例 2 - すべての非定数エイリアスを削除する

次の使用例は、Options プロパティが Constant に設定されているエイリアスを除き、現在の PowerShell セッションからすべてのエイリアスを削除します。 コマンドの実行後、エイリアスは他の PowerShell セッションまたは新しい PowerShell セッションで使用できます。

Get-Alias | Where-Object { $_.Options -NE "Constant" } | Remove-Alias -Force

Get-Alias は、PowerShell セッション内のすべてのエイリアスを取得し、パイプラインにオブジェクトを送信します。 Where-Object はスクリプト ブロックを使用し、自動変数 ($_) と Options プロパティは現在のパイプライン オブジェクトを表します。 パラメーター NE (等しくない) は、Options 値が定数に設定されていないオブジェクトを選択します。 Remove-Aliasでは、Force パラメーターを使用して、読み取り専用エイリアスを含むエイリアスを PowerShell セッションから削除します。 Force パラメーターは定数エイリアスを削除できません。

パラメーター

-Force

コマンドレットがエイリアスを削除することを示します。これには、Option プロパティが ReadOnly に設定されたエイリアスが含まれます。 Force パラメーターは、Option プロパティが Constant に設定されているエイリアスを削除できません。

Type:SwitchParameter
Position:Named
Default value:False
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

-Scope

指定したスコープ内のエイリアスにのみ影響します。 既定のスコープは Local です。 詳細については、「about_Scopes」を参照してください。

このパラメーターの有効値は、次のとおりです。

  • Global
  • Local
  • Script
  • 現在のスコープに対する相対的な数値 (0 からスコープの数、0 が現在のスコープ、1 がその親)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String[]

エイリアス オブジェクトをこのコマンドレットにパイプできます。

出力

None

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

メモ

変更は現在のスコープにのみ影響します。 すべてのセッションからエイリアスを削除するには、PowerShell プロファイルにコマンドを追加 Remove-Alias します。

詳細については、「about_Aliases」を参照してください。