Test-PSSessionConfigurationFile

Test-PSSessionConfigurationFile
    [-Path] <String>
    [<CommonParameters>]

Этот командлет доступен только на платформе Windows.

Этот командлет проверяет, содержит ли файл конфигурации сеанса допустимые ключи и значения имеют правильный тип. Для перечисленных значений командлет проверяет, допустимы ли указанные значения.

Командлет возвращает $true, если файл проходит все тесты и $false, если это не так. Чтобы найти ошибки, используйте параметр Подробные.

Test-PSSessionConfigurationFile проверяет файлы конфигурации сеанса, например файлы конфигурации сеанса, созданные командлетом New-PSSessionConfigurationFile. Сведения о конфигурациях сеансов см. в about_Session_Configurations. Сведения о файлах конфигурации сеанса см. в about_Session_Configuration_Files.

Этот командлет был введён в PowerShell 3.0.

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

В этом примере мы протестируем файл конфигурации, используемый в конфигурации сеанса с ограниченным доступом. Значение параметра пути является результатом команды Get-PSSessionConfiguration, которая получает конфигурацию сеанса с ограниченным доступом. Путь к файлу конфигурации сеанса хранится в значении свойства ConfigFilePath конфигурации сеанса.

Test-PSSessionConfigurationFile -Path (Get-PSSessionConfiguration -Name Restricted).ConfigFilePath

Функция в этом примере проверяет все файлы конфигурации сеанса на локальном компьютере. Функция использует командлет Get-PSSessionConfiguration для получения всех конфигураций сеансов. Код внутри цикла ForEach-Object отображает путь к файлу и проверяет каждую конфигурацию сеанса.

function Test-AllConfigFiles
{
    Get-PSSessionConfiguration | ForEach-Object {
        if ($_.ConfigFilePath) {
            $_.ConfigFilePath
            Test-PSSessionConfigurationFile -Verbose -Path $_.ConfigFilePath
        }
    }
}
Test-AllConfigFiles

C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Empty_6fd77bf6-e084-4372-bd8a-af3e207354d3.pssc
True
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Full_1e9cb265-dae0-4bd3-89a9-8338a47698a1.pssc
VERBOSE: The member 'AliasDefinitions' must contain the required key 'Description'. Add the require key
to the fileC:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Full_1e9cb265-dae0-4bd3-89a9-8338a47698a1.pssc.
False
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\NoLanguage_0c115179-ff2a-4f66-a5eb-e56e5692ba22.pssc
True
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\RestrictedLang_b6bd9474-0a6c-4e06-8722-c2c95bb10d3e.pssc
True
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\RRS_3fb29420-2c87-46e5-a402-e21436331efc.pssc
True

Свойство ConfigFilePath конфигурации сеанса содержит путь к файлу конфигурации сеанса, который используется в конфигурации сеанса( если таковой имеется).

Если значение свойства ConfigFilePath заполнено (имеет значение true), команда получает (печатает) значение свойства ConfigFilePath. Затем он использует командлет Test-PSSessionConfigurationFile для тестирования файла в значении ConfigFilePath. Параметр Verbose возвращает ошибку файла, когда файл не проходит тест.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Путь к файлу конфигурации сеанса можно передать этому командлету.

Этот командлет доступен только на платформах Windows.