Enable-PSSessionConfiguration
로컬 컴퓨터에서 세션 구성을 사용하도록 설정합니다.
구문
Default (기본값)
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.
Enable-PSSessionConfiguration cmdlet을 사용하면 Disable-PSSessionConfiguration 또는 Disable-PSRemoting cmdlet을 사용하거나 Register-PSSessionConfiguration 매개 변수를 사용하는 등 사용하지 않도록 설정된 등록된 세션 구성을 사용할 수 있습니다. 시스템 관리자가 사용자에 대한 사용자 지정 세션 구성을 관리하는 데 사용하도록 설계된 고급 cmdlet입니다.
매개 변수가 없으면 Enable-PSSessionConfiguration 세션에 사용되는 기본 구성인 Microsoft.PowerShell 구성을 사용하도록 설정합니다.
Enable-PSSessionConfiguration 영향을 받는 세션 구성의 보안 설명자에서 Deny_All 설정을 제거하고, IP 주소에 대한 요청을 수락하는 수신기를 켜고, WinRM 서비스를 다시 시작합니다. PowerShell 3.0부터 Enable-PSSessionConfiguration 세션 구성()의 WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled 속성 값도 True로 설정합니다. 그러나 Enable-PSSessionConfiguration 로컬 컴퓨터의 사용자만 세션 구성에 사용할 수 있는 Network_Deny_All(AccessMode=Local) 보안 설명자 설정을 제거하거나 변경하지 않습니다.
예제
예제 1: 기본 세션 다시 사용
이 예제에서는 컴퓨터에서 Microsoft.PowerShell 기본 세션 구성을 다시 사용하도록 설정합니다.
Enable-PSSessionConfiguration
예제 2: 지정된 세션 다시 사용
이 예제에서는 컴퓨터에서 MaintenanceShell 및 AdminShell 세션 구성을 다시 사용하도록 설정합니다.
Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell
예제 3: 모든 세션 다시 사용
이 예제에서는 컴퓨터의 모든 세션 구성을 다시 사용하도록 설정합니다. 이러한 명령은 동일합니다. 따라서 둘 중 하나를 사용할 수 있습니다.
Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration
Enable-PSSessionConfiguration 이미 사용하도록 설정된 세션 구성을 사용하도록 설정한 경우 오류를 생성하지 않습니다.
예제 4: 세션을 다시 사용하도록 설정하고 새 보안 설명자 지정
이 예제에서는 MaintenanceShell 세션 구성을 다시 사용하도록 설정하고 구성에 대한 새 보안 설명자를 지정합니다.
$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
cmdlet에서 확인 메시지를 표시하지 않고 메시지를 표시하지 않고 WinRM 서비스를 다시 시작합니다. 서비스를 다시 시작하면 구성 변경이 적용됩니다.
다시 시작을 방지하고 다시 시작 프롬프트를 표시하지 않도록 하려면 NoServiceRestart 매개 변수를 사용합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Name
사용하도록 설정할 세션 구성의 이름을 지정합니다. 하나 이상의 구성 이름을 입력합니다. 와일드카드 문자가 허용됩니다.
구성 이름 또는 세션 구성 개체가 포함된 문자열을 파이프하여 Enable-PSSessionConfiguration수도 있습니다.
이 매개 변수를 생략하면 Enable-PSSessionConfigurationMicrosoft.PowerShell 세션 구성을 사용하도록 설정합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-NoServiceRestart
cmdlet이 서비스를 다시 시작하지 않음을 나타냅니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SecurityDescriptorSddl
이 cmdlet이 세션 구성의 보안 설명자를 대체하는 보안 설명자를 지정합니다.
이 매개 변수를 생략하면 Enable-PSSessionConfiguration 보안 설명자에서 모든 거부 항목만 삭제합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SkipNetworkProfileCheck
이 cmdlet은 컴퓨터가 공용 네트워크에 있을 때 세션 구성을 사용하도록 설정됨을 나타냅니다. 이 매개 변수는 동일한 로컬 서브넷에 있는 컴퓨터에서만 원격 액세스를 허용하는 공용 네트워크에 대한 방화벽 규칙을 사용하도록 설정합니다. 기본적으로 Enable-PSSessionConfiguration 공용 네트워크에서 실패합니다.
이 매개 변수는 Windows 운영 체제의 클라이언트 버전을 위해 설계되었습니다. Windows 운영 체제의 서버 버전에는 공용 네트워크에 대한 로컬 서브넷 방화벽 규칙이 있습니다. 그러나 Windows 운영 체제의 서버 버전에서 로컬 서브넷 방화벽 규칙을 사용하지 않도록 설정하면 이 매개 변수를 다시 사용하도록 설정합니다.
로컬 서브넷 제한을 제거하고 공용 네트워크의 모든 위치에서 원격 액세스를 사용하도록 설정하려면 NetSecurity 모듈의 Set-NetFirewallRule cmdlet을 사용합니다. 자세한 내용은 Enable-PSRemoting를 참조하세요.
이 매개 변수는 PowerShell 3.0에서 도입되었습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
세션 구성 개체 또는 세션 구성의 이름이 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 개체를 반환하지 않습니다.
참고
이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.
이 cmdlet을 사용하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작해야 합니다.
관련 링크
- PSSession 구성 비활성화
- Get-PSSessionConfiguration (PowerShell 구성 가져오기)
- New-PSSessionConfigurationFile
- New-PSSessionOption (새 PS 세션 옵션)
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration (세션 구성 설정)
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan 공급자
- 세션 구성에 대하여
- 세션 구성 파일에 관한 정보