Bagikan melalui


Get-Alias

Mendapatkan alias untuk sesi saat ini.

Sintaks

Default (Default)

Get-Alias
    [[-Name] <String[]>]
    [-Exclude <String[]>]
    [-Scope <String>]
    [<CommonParameters>]

Definition

Get-Alias
    [-Exclude <String[]>]
    [-Scope <String>]
    [-Definition <String[]>]
    [<CommonParameters>]

Deskripsi

cmdlet Get-Alias mendapatkan alias dalam sesi saat ini. Ini termasuk alias bawaan, alias yang telah Anda tetapkan atau impor, dan alias yang telah Anda tambahkan ke profil PowerShell Anda.

Secara default, Get-Alias mengambil alias dan mengembalikan nama perintah. Saat Anda menggunakan parameter Definisi, Get-Alias mengambil nama perintah dan mengembalikan aliasnya.

Dimulai di Windows PowerShell 3.0, Get-Alias menampilkan nama alias yang tidak dipending dalam format <alias> -> <definition> untuk membuatnya lebih mudah menemukan informasi yang Anda butuhkan.

Contoh

Contoh 1: Dapatkan semua alias dalam sesi saat ini

Get-Alias
CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           asnp -> Add-PSSnapin
Alias           cat -> Get-Content
Alias           cd -> Set-Location
Alias           chdir -> Set-Location
Alias           clc -> Clear-Content
Alias           clear -> Clear-Host
Alias           clhy -> Clear-History
...

Perintah ini mendapatkan semua alias dalam sesi saat ini.

Output menunjukkan format <alias> -> <definition> yang diperkenalkan di Windows PowerShell 3.0. Format ini hanya digunakan untuk alias yang tidak menyertakan tanda hubung, karena alias dengan tanda hubung biasanya merupakan nama pilihan untuk cmdlet dan fungsi, bukan nama panggilan.

Contoh 2: Dapatkan alias berdasarkan nama

Get-Alias -Name gp*, sp* -Exclude *ps

Perintah ini mendapatkan semua alias yang dimulai dengan gp atau sp, kecuali untuk alias yang diakhir dengan ps.

Contoh 3: Mendapatkan alias untuk cmdlet

Get-Alias -Definition Get-ChildItem

Perintah ini mendapatkan alias untuk cmdlet Get-ChildItem.

Secara default, cmdlet Get-Alias mendapatkan nama item saat Anda mengetahui alias. Parameter Definisi mendapatkan alias saat Anda mengetahui nama item.

Contoh 4: Dapatkan alias menurut properti

Get-Alias | Where-Object {$_.Options -match "ReadOnly"}

Perintah ini mendapatkan semua alias di mana nilai properti OpsiReadOnly. Perintah ini menyediakan cara cepat untuk menemukan alias yang dibangun ke dalam PowerShell, karena mereka memiliki opsi ReadOnly.

Opsi hanyalah satu properti objek AliasInfo yang Get-Alias dapatkan. Untuk menemukan semua properti dan metode objek AliasInfo, ketik Get-Alias | Get-Member.

Contoh 5: Dapatkan alias menurut nama dan filter menurut huruf awal

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

Contoh ini mendapatkan alias untuk perintah yang memiliki nama yang berakhiran "-PSSession", kecuali untuk yang dimulai dengan "e".

Perintah menggunakan parameter Cakupan untuk menerapkan perintah dalam cakupan global. Ini berguna dalam skrip ketika Anda ingin mendapatkan alias dalam sesi.

Parameter

-Definition

Mendapatkan alias untuk item yang ditentukan. Masukkan nama cmdlet, fungsi, skrip, file, atau file yang dapat dieksekusi.

Parameter ini disebut Definisi, karena mencari nama item di properti Definisi objek alias.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

Definition
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Exclude

Menghilangkan item yang ditentukan. Nilai parameter ini memenuhi syarat Nama dan parameter Definisi. Masukkan nama, definisi, atau pola, seperti "s*". Kartu liar diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
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 alias yang didapat cmdlet ini. Kartu liar diizinkan. Secara default, Get-Alias mengambil semua alias yang ditentukan untuk sesi saat ini. Nama parameter Nama bersifat opsional. Anda juga dapat menyalurkan nama alias ke Get-Alias.

Properti parameter

Jenis:

String[]

Nilai default:All aliases
Mendukung wildcard:True
DontShow:False

Set parameter

Default
Position:0
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Scope

Menentukan cakupan di mana cmdlet ini mendapatkan alias. 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)

Local adalah default. Untuk informasi selengkapnya, lihat about_Scopes.

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 string yang berisi nama alias ke cmdlet ini.

Output

AliasInfo

Cmdlet ini mengembalikan objek yang mewakili setiap alias. Ini mengembalikan tipe objek yang sama untuk setiap alias, tetapi PowerShell menggunakan format berbasis panah untuk menampilkan nama alias yang tidak dipending.

Catatan

PowerShell menyertakan alias berikut untuk Get-Alias:

  • Semua platform:

    • gal
  • Untuk membuat alias baru, gunakan Set-Alias atau New-Alias. Untuk menghapus alias, gunakan Remove-Item.

  • Format nama alias berbasis panah tidak digunakan untuk alias yang menyertakan tanda hubung. Ini cenderung menjadi nama pengganti pilihan untuk cmdlet dan fungsi, alih-alih singkatan atau nama panggilan umum.