Test-PSSessionConfigurationFile
Проверяет ключи и значения в файле конфигурации сеанса.
Синтаксис
Test-PSSessionConfigurationFile
[-Path] <String>
[<CommonParameters>]
Описание
Этот командлет проверяет, содержит ли файл конфигурации сеанса допустимые ключи, а значения имеют правильный тип. Для перечисляемых значений командлет проверяет правильность указанных значений.
Командлет возвращает значение $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 |
Входные данные
Путь к файлу конфигурации сеанса можно передать в Test-PSSessionConfigurationFile
.
Выходные данные
Примечания
Этот командлет доступен только на платформах Windows.
Связанные ссылки
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Provider
- about_Session_Configurations
- about_Session_Configuration_Files