Test-PSSessionConfigurationFile
세션 구성 파일에서 키와 값을 확인합니다.
구문
Default (기본값)
Test-PSSessionConfigurationFile
[-Path] <String>
[<CommonParameters>]
Description
이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.
이 cmdlet은 세션 구성 파일에 유효한 키가 포함되어 있고 값이 올바른 형식인지 확인합니다. 열거형 값의 경우 cmdlet은 지정된 값이 유효한지 확인합니다.
cmdlet은 파일이 모든 테스트를 통과하면 $true 반환하고 그렇지 않으면 $false. 오류를 찾으려면 Verbose 매개 변수를 사용합니다.
Test-PSSessionConfigurationFile
New-PSSessionConfigurationFile cmdlet에서 만든 파일과 같은 세션 구성 파일을 확인합니다. 세션 구성에 대한 자세한 내용은 about_Session_Configurations참조하세요. 세션 구성 파일에 대한 자세한 내용은 about_Session_Configuration_Files참조하세요.
이 cmdlet은 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 cmdlet을 사용하여 모든 세션 구성을 가져옵니다.
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 cmdlet을 사용하여 ConfigFilePath 값의 파일을 테스트합니다.
자세한 정보 표시 매개 변수는 파일이 테스트에 실패하면 파일 오류를 반환합니다.
매개 변수
-Path
세션 구성 파일(.pssc)의 경로 및 파일 이름을 지정합니다. 경로를 생략하면 기본값은 현재 폴더입니다. 와일드카드 문자는 지원되지만 하나의 파일로 처리되어야 합니다. 세션 구성 파일 경로를 Test-PSSessionConfigurationFile로 전달할 수도 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
String
세션 구성 파일 경로를 이 cmdlet으로 파이프할 수 있습니다.
출력
Boolean
참고
이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.
관련 링크
- PSSession 구성 비활성화
- Enable-PSSessionConfiguration (PSSession 구성 사용 설정)
- Get-PSSessionConfiguration (PowerShell 구성 가져오기)
- New-PSSessionConfigurationFile
- New-PSSessionOption (새 PS 세션 옵션)
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration (세션 구성 설정)
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan 공급자
- 세션 구성에 대하여
- 세션 구성 파일에 관한 정보