AvoidUsingCmdletAliases

Tingkat Keparahan : Peringatan

Deskripsi

Alias adalah nama alternatif atau nama panggilan untuk cmdlet atau untuk elemen perintah, seperti fungsi, skrip, file, atau file yang dapat dieksekusi. Anda dapat menggunakan alias alih-alih nama perintah dalam perintah PowerShell apa pun.

Ada juga alias implisit. Ketika PowerShell tidak dapat menemukan nama cmdlet, PowerShell akan mencoba menambahkan Get- ke perintah sebagai upaya terakhir. Oleh karena itu, menggunakan perintah verb akan menjalankan Get-Verb.

Setiap penulis PowerShell mempelajari nama perintah aktual, tetapi penulis yang berbeda mempelajari dan menggunakan alias yang berbeda. Alias dapat membuat kode sulit dibaca, dipahami, dan memengaruhi ketersediaan.

Menggunakan nama perintah lengkap memudahkan untuk mempertahankan skrip Anda di masa mendatang.

Menggunakan nama perintah lengkap juga memungkinkan penyorotan sintaks di situs dan aplikasi seperti GitHub dan Visual Studio Code.

Cara Memperbaiki

Gunakan nama cmdlet lengkap dan bukan alias.

Daftar Izin Alias

Untuk mencegah PSScriptAnalyzer menandai alias pilihan Anda, buat daftar alias yang diizinkan dalam file pengaturan Anda dan arahkan PSScriptAnalyzer untuk menggunakan file pengaturan. Misalnya, untuk menonaktifkan PSScriptAnalyzer dari menandai cd, yang merupakan alias Set-Location, atur konten file pengaturan ke yang berikut ini.

# PSScriptAnalyzerSettings.psd1

@{
    'Rules' = @{
        'PSAvoidUsingCmdletAliases' = @{
            'allowlist' = @('cd')
        }
    }
}

Contoh

Salah

gps | Where-Object {$_.WorkingSet -gt 20000000}

Benar

Get-Process | Where-Object {$_.WorkingSet -gt 20000000}