UseCompatibleCmdlets

Tingkat Keparahan : Peringatan

Status default: Selalu diaktifkan

Deskripsi

Aturan ini mendeteksi cmdlet yang tidak tersedia untuk edisi, versi, dan sistem operasi PowerShell yang Anda targetkan. Aturan ini membandingkan setiap cmdlet dalam skrip Anda dengan daftar izin kompatibilitas yang dikirimkan dengan PSScriptAnalyzer. File-file ini berada di lokasi berikut: /path/to/PSScriptAnalyzerModule/Settings.

Setiap file menggunakan format penamaan ini:

<psedition>-<psversion>-<os>.json

Where:

• <psedition> Core atau Desktop
• <psversion> adalah versi PowerShell
• <os> adalah Windows, Linux, Linux-Arm, atau MacOS

Mengonfigurasi aturan

Untuk memeriksa apakah skrip Anda kompatibel dengan PowerShell Core 6.1 di Windows, tambahkan konfigurasi ini:

@{
    'Rules' = @{
        'PSUseCompatibleCmdlets' = @{
            'compatibility'      = @('core-6.1.0-windows')
        }
    }
}

Parameter kompatibilitas menerima daftar satu atau beberapa ID target, seperti:

• desktop-2.0-windows
• desktop-3.0-windows
• desktop-4.0-windows (diambil dari Windows Server 2012 R2)
• desktop-5.1.14393.206-windows
• core-6.1.0-windows (diambil dari Windows 10, versi 1803)
• core-6.1.0-linux (diambil dari Ubuntu 18.04)
• core-6.1.0-linux-arm (diambil dari Raspbian)
• core-6.1.0-macos

Versi PowerShell yang ditambal biasanya memiliki data cmdlet yang sama, sehingga aturan ini terutama mengirimkan profil versi mayor dan minor.

Anda juga dapat membuat profil khusus dengan New-CommandDataFile.ps1. Tempatkan file JSON yang dihasilkan di Settings folder PSScriptAnalyzer modul. Kemudian Anda dapat mereferensikan file tersebut dengan nama di bawah compatibility.

core-6.0.2-* File dihapus di PSScriptAnalyzer 1.18 karena PowerShell 6.0 mencapai akhir masa pakainya.

Meskipun aturan dapat dikonfigurasi, aturan selalu diaktifkan. Gunakan salah satu metode berikut untuk menghindari penggunaan aturan ini:

• Buat file konfigurasi aturan kustom untuk hanya menyertakan aturan yang Anda inginkan atau kecualikan aturan yang tidak Anda inginkan.
• Tambahkan atribut penekanan aturan yang sesuai ke kode Anda untuk menekan aturan untuk blok kode tertentu. Untuk informasi selengkapnya, lihat bagian Menekan aturanMenggunakan PSScriptAnalyzer.