Remove-Alias

Hapus alias dari sesi saat ini.

Sintaks

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

Deskripsi

Remove-Alias Cmdlet menghapus alias dari sesi PowerShell saat ini. Untuk menghapus alias dengan properti Opsi diatur ke ReadOnly, gunakan parameter Paksa.

Remove-Alias Cmdlet diperkenalkan di PowerShell 6.0.

Contoh

Contoh 1 - Menghapus alias

Contoh ini menghapus alias bernama del yang mewakili Remove-Item cmdlet.

Remove-Alias -Name del

Contoh 2 - Hapus semua alias non-Konstanta

Contoh ini menghapus semua alias dari sesi PowerShell saat ini, kecuali untuk alias dengan properti Opsi yang diatur ke Konstanta. Setelah perintah dijalankan, alias tersedia di sesi PowerShell lainnya atau sesi PowerShell baru.

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

Get-Alias mendapatkan semua alias dalam sesi PowerShell dan mengirim objek ke bawah alur. Where-Object menggunakan blok skrip, dan variabel otomatis ($_) dan properti Opsi mewakili objek alur saat ini. PARAMETER NE (tidak sama dengan), memilih objek yang tidak memiliki nilai Opsi yang diatur ke Konstanta. Remove-Aliasmenggunakan parameter Paksa untuk menghapus alias, termasuk alias baca-saja, dari sesi PowerShell. Parameter Paksa tidak dapat menghapus alias Konstanta .

Parameter

-Force

Menunjukkan bahwa cmdlet menghapus alias, termasuk alias dengan properti Opsi diatur ke ReadOnly. Parameter Paksa tidak dapat menghapus alias dengan properti Opsi diatur ke Konstanta.

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

-Name

Menentukan nama alias yang akan dihapus.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Hanya memengaruhi alias dalam cakupan yang ditentukan. Cakupan defaultnya adalah Lokal. Untuk informasi selengkapnya, lihat about_Scopes.

Nilai yang dapat diterima untuk parameter ini adalah:

  • Global
  • Local
  • Script
  • Angka relatif terhadap cakupan saat ini (0 melalui jumlah cakupan, di mana 0 adalah cakupan saat ini dan 1 adalah induknya)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String[]

Anda dapat menyalurkan objek alias ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Perubahan hanya memengaruhi cakupan saat ini. Untuk menghapus alias dari semua sesi, tambahkan Remove-Alias perintah ke profil PowerShell Anda.

Untuk informasi selengkapnya, lihat about_Aliases.