Test-PSSessionConfigurationFile

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Проверяет ключи и значения в файле конфигурации сеанса.

Синтаксис

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

Описание

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

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

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

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

Этот командлет появился в PowerShell 3.0.

Примеры

Пример 1. Проверка файла конфигурации сеанса

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Пример 2. Проверка файла конфигурации сеанса конфигурации сеанса

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

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

Пример 3. Тестирование всех файлов конфигурации сеанса

Функция в этом примере проверяет все файлы конфигурации сеанса на локальном компьютере. Функция использует 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 . Подробный параметр возвращает ошибку файла, когда файл завершается сбоем теста.

Параметры

-Path

Указывает путь и имя файла конфигурации сеанса (PSSC). Если вы опустите путь, по умолчанию используется текущая папка. Поддерживаются символы Wild карта, но они должны разрешаться в один файл. Вы также можете передать путь к Test-PSSessionConfigurationFileфайлу конфигурации сеанса.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

Входные данные

String

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

Выходные данные

Boolean

Примечания

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