Enable-PSSessionConfiguration

  • 참조
모듈:
Microsoft.PowerShell.Core

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

Syntax

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

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

cmdlet은 Enable-PSSessionConfiguration 사용하거나 cmdlet을 사용하거나 Disable-PSRemotingAccessMode 매개 변수Register-PSSessionConfiguration를 사용하는 Disable-PSSessionConfiguration 등 사용하지 않도록 설정된 등록된 세션 구성을 사용하도록 설정합니다. 이 cmdlet은 시스템 관리자가 사용자에 대한 사용자 지정 세션을 관리하는 데 사용할 수 있는 고급 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 및 관리Shell 세션 구성을 다시 사용하도록 설정합니다.

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을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

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

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

-NoServiceRestart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

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

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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

세션 구성 개체를 이 cmdlet으로 파이프할 수 있습니다.

String

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

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

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