Bagikan melalui

Remove-Alias

Modul:
Microsoft.PowerShell.Utility Module

Hapus alias dari sesi saat ini.

Sintaks

Default (Default) 

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

Deskripsi

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

Cmdlet Remove-Alias diperkenalkan di PowerShell 6.0.

Contoh

Contoh 1 - Menghapus alias

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

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 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. Operator -ne (tidak sama dengan) memilih objek yang tidak memiliki nilai Opsi diatur ke Konstanta . Remove-Alias menggunakan parameter Force untuk menghapus alias, termasuk alias baca-saja, dari sesi PowerShell. Parameter Force tidak dapat menghapus alias Konstanta.

Parameter

-Force

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

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama alias yang akan dihapus.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Scope

Hanya memengaruhi alias dalam cakupan yang ditentukan. Cakupan default 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)

Properti parameter

Jenis:String
Nilai default:Local
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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 perintah Remove-Alias ke profil PowerShell Anda.

Untuk informasi selengkapnya, lihat about_Aliases.