UseCompatibleCommands

allvarlighetsgrad: Varning

Beskrivning

Den här regeln identifierar kommandon som inte är tillgängliga på en riktad PowerShell-plattform.

En PowerShell-plattform identifieras med ett namn i följande format:

<os-name>_<os-arch>_<os-version>_<ps-version>_<ps-arch>_<dotnet-version>_<dotnet-edition>

Var:

• <os-name>: Namnet på operativsystemet PowerShell körs på. I Windows innehåller detta SKU-numret. I Linux är det här namnet på distributionen.
• <os-arch>: Datorarkitekturen som operativsystemet körs på (detta är vanligtvis x64).
• <os-version>: Den självrapporterade versionen av operativsystemet (i Linux är det här distributionsversionen).
• <ps-version>: PowerShell-versionen (från $PSVersionTable.PSVersion).
• <ps-arch>: Datorarkitekturen för PowerShell-processen.
• <dotnet-version>: Den rapporterade versionen av .NET Runtime PowerShell körs på (från System.Environment.Version).
• <dotnet-edition>: .NET-körningssmaken PowerShell körs på (för närvarande framework eller core).

Till exempel:

• win-4_x64_10.0.18312.0_5.1.18312.1000_x64_4.0.30319.42000_framework körs PowerShell 5.1 på Windows 10 Enterprise (version 18312) för x64.
• win-4_x64_10.0.18312.0_6.1.2_x64_4.0.30319.42000_core körs PowerShell 6.1.2 på samma operativsystem.
• ubuntu_x64_18.04_6.2.0_x64_4.0.30319.42000_core körs PowerShell 6.2.0 på Ubuntu 18.04.

Vissa plattformar levereras med PSScriptAnalyzer som JSON-filer, namngivna på det här sättet för målinriktning i konfigurationen.

Plattformar som paketeras som standard är:

Andra profiler finns på GitHub-lagringsplatsen.

Du kan också generera en egen plattformsprofil med hjälp av modulen PSCompatibilityCollector.

Inställningarna för kompatibilitetsprofilen tar en lista över plattformar som ska riktas under TargetProfiles. En plattform kan anges som:

• Ett plattformsnamn (till exempel ubuntu_x64_18.04_6.1.1_x64_4.0.30319.42000_core), som kommer att ha .json lagts till i slutet och söks efter i standardprofilkatalogen.
• Ett filnamn (till exempel my_custom_platform.json), som söks efter i standardprofilkatalogen.
• En absolut sökväg till en fil (som D:\PowerShellProfiles\TargetMachine.json).

Standardprofilkatalogen finns under MODULen PSScriptAnalzyer på $PSScriptRoot/compatibility_profiles (där $PSScriptRoot här refererar till katalogen som innehåller PSScriptAnalyzer.psd1).

Kompatibilitetsanalysen jämför ett kommando som används för både en målprofil och en "union"-profil (som innehåller alla kommandon som är tillgängliga i alla profil i profildir). Om ett kommando inte finns i unionsprofilen antas det vara lokalt skapat och ignorerat. Om ett kommando finns i unionsprofilen men inte finns i ett mål anses det annars vara inkompatibelt med det målet.

Konfigurationsinställningar

En exempelkonfiguration kan se ut så här:

@{
    Rules = @{
        PSUseCompatibleCommands = @{
            Enable = $true
            TargetProfiles = @(
                'ubuntu_x64_18.04_6.1.3_x64_4.0.30319.42000_core'
                'win-48_x64_10.0.17763.0_5.1.17763.316_x64_4.0.30319.42000_framework'
                'MyProfile'
                'another_custom_profile_in_the_profiles_directory.json'
                'D:\My Profiles\profile1.json'
            )
            # You can specify commands to not check like this, which also will ignore its parameters:
            IgnoreCommands = @(
                'Install-Module'
            )
        }
    }
}

Undertryckande

Kommandokompatibilitetsdiagnostik kan ignoreras med ett attribut på param-blocket i en scriptblock som med andra regler.

[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseCompatibleCommands', '')]

Regeln kan också ignoreras endast för vissa kommandon:

[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseCompatibleCommands',
    'Start-Service')]

Och undertrycks endast för parametrar:

[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseCompatibleCommands',
    'Import-Module/FullyQualifiedName')]