다음을 통해 공유

Enable-PSSessionConfiguration

  • 참조
모듈:
Microsoft.PowerShell.Core

로컬 컴퓨터에서 세션 구성을 사용하도록 설정합니다.

구문

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Enable-PSSessionConfiguration cmdlet을 사용하면 Disable-PSSessionConfiguration 또는 Disable-PSRemoting cmdlet을 사용하거나 Register-PSSessionConfigurationAccessMode 매개 변수를 사용하는 등 사용하지 않도록 설정된 등록된 세션 구성을 사용할 수 있습니다. 시스템 관리자가 사용자에 대한 사용자 지정 세션 구성을 관리하는 데 사용하도록 설계된 고급 cmdlet입니다.

매개 변수가 없으면 Enable-PSSessionConfiguration 세션에 사용되는 기본 구성인 Microsoft.PowerShell 구성을 사용하도록 설정합니다.

Enable-PSSessionConfiguration 영향을 받는 세션 구성의 보안 설명자에서 Deny_All 설정을 제거하고, IP 주소에 대한 요청을 수락하는 수신기를 켜고, WinRM 서비스를 다시 시작합니다. PowerShell 3.0부터 Enable-PSSessionConfiguration 세션 구성(WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled)의 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
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

cmdlet에서 확인 메시지를 표시하지 않고 메시지를 표시하지 않고 WinRM 서비스를 다시 시작합니다. 서비스를 다시 시작하면 구성 변경이 적용됩니다.

다시 시작을 방지하고 다시 시작 프롬프트를 표시하지 않도록 하려면 NoServiceRestart 매개 변수를 사용합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

사용하도록 설정할 세션 구성의 이름을 지정합니다. 하나 이상의 구성 이름을 입력합니다. 와일드카드 문자가 허용됩니다.

구성 이름 또는 세션 구성 개체가 포함된 문자열을 파이프하여 Enable-PSSessionConfiguration수도 있습니다.

이 매개 변수를 생략하면 Enable-PSSessionConfigurationMicrosoft.PowerShell 세션 구성을 사용하도록 설정합니다.

형식:String[]
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-NoServiceRestart

cmdlet이 서비스를 다시 시작하지 않음을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SecurityDescriptorSddl

이 cmdlet이 세션 구성의 보안 설명자를 대체하는 보안 설명자를 지정합니다.

이 매개 변수를 생략하면 Enable-PSSessionConfiguration 보안 설명자에서 모든 거부 항목만 삭제합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkipNetworkProfileCheck

이 cmdlet은 컴퓨터가 공용 네트워크에 있을 때 세션 구성을 사용하도록 설정됨을 나타냅니다. 이 매개 변수는 동일한 로컬 서브넷에 있는 컴퓨터에서만 원격 액세스를 허용하는 공용 네트워크에 대한 방화벽 규칙을 사용하도록 설정합니다. 기본적으로 Enable-PSSessionConfiguration 공용 네트워크에서 실패합니다.

이 매개 변수는 Windows 운영 체제의 클라이언트 버전을 위해 설계되었습니다. Windows 운영 체제의 서버 버전에는 공용 네트워크에 대한 로컬 서브넷 방화벽 규칙이 있습니다. 그러나 Windows 운영 체제의 서버 버전에서 로컬 서브넷 방화벽 규칙을 사용하지 않도록 설정하면 이 매개 변수를 다시 사용하도록 설정합니다.

로컬 서브넷 제한을 제거하고 공용 네트워크의 모든 위치에서 원격 액세스를 사용하도록 설정하려면 NetSecurity 모듈의 Set-NetFirewallRule cmdlet을 사용합니다. 자세한 내용은 Enable-PSRemoting참조하세요.

이 매개 변수는 PowerShell 3.0에서 도입되었습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

세션 구성 개체 또는 세션 구성의 이름이 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 개체를 반환하지 않습니다.

참고

이 cmdlet을 사용하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작해야 합니다.