Поделиться через

Test-PSSessionConfigurationFile

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

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

Синтаксис

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

Описание

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

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

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

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 . Параметр Verbose возвращает ошибку файла, если файл не проходит проверку.

Параметры

-Path

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

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

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

String

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

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

Boolean

Примечания

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