UseCompatibleCmdlets

Nível de gravidade: aviso

Descrição

Essa regra sinaliza cmdlets que não estão disponíveis em uma determinada edição e versão do PowerShell em um determinado sistema operacional. Ele funciona comparando um cmdlet com um conjunto de listas de permissões que são enviadas com PSScriptAnalyzer. Eles podem ser encontrados em /path/to/PSScriptAnalyzerModule/Settings. Esses arquivos são do formulário, <psedition>-<psversion>-<os>.json em que <psedition> pode ser Core ou Desktop, <os> pode ser Windows, Linux ou MacOSe <psversion> é a versão do PowerShell. Para habilitar a regra para verificar se o script é compatível com o PowerShell Core no Windows, coloque o seguinte arquivo de configurações:

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

O parâmetro compatibility é uma lista que contém qualquer um dos seguintes

• desktop-2.0-windows
• desktop-3.0-windows
• desktop-4.0-windows (obtido do Windows Server 2012R2)
• desktop-5.1.14393.206-windows
• core-6.1.0-windows (obtido do Windows 10 – 1803)
• core-6.1.0-linux (obtido do Ubuntu 18.04)
• core-6.1.0-linux-arm (retirado do Raspbian)
• core-6.1.0-macos

Normalmente, as versões corrigidas do PowerShell têm os mesmos dados de cmdlet, portanto, somente as configurações das versões principais e secundárias do PowerShell são fornecidas. Você também pode criar um arquivo de configurações personalizado com o script New-CommandDataFile.ps1. Coloque o arquivo .json criado na pasta Settings da pasta do módulo PSScriptAnalyzer. Em seguida, os valores de parâmetro compatibility são apenas o nome do arquivo. Observe que os arquivos core-6.0.2-* foram removidos no PSScriptAnalyzer 1.18 desde que o PowerShell 6.0 atingiu seu fim de vida útil.