다음을 통해 공유

Disable-PSSessionConfiguration

모듈:
Microsoft.PowerShell.Core Module

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

구문

Default (기본값) 

Disable-PSSessionConfiguration
    [[-Name] <String[]>]
    [-Force]
    [-NoServiceRestart]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Disable-PSSessionConfiguration cmdlet은 로컬 컴퓨터에서 세션 구성을 사용하지 않도록 설정하므로 모든 사용자가 세션 구성을 사용하여 로컬 컴퓨터에서 사용자 관리 세션(PSSessions)을 만들 수 없습니다. 시스템 관리자가 사용자에 대한 사용자 지정 세션 구성을 관리하는 데 사용하도록 설계된 고급 cmdlet입니다.

PowerShell 3.0부터 Disable-PSSessionConfiguration cmdlet은 세션 구성()의 WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled 설정을 False로 변경합니다.

PowerShell 2.0에서 Disable-PSSessionConfiguration cmdlet은 하나 이상의 등록된 세션 구성의 보안 설명자에 Deny_All 항목을 추가합니다.

매개 변수가 없으면 Disable-PSSessionConfiguration 세션에 사용되는 기본 구성인 Microsoft.PowerShell 구성을 사용하지 않도록 설정합니다. 사용자가 다른 구성을 지정하지 않는 한 로컬 사용자와 원격 사용자 모두 컴퓨터에 연결하는 세션을 효과적으로 만들 수 없습니다.

컴퓨터에서 모든 세션 구성을 사용하지 않도록 설정하려면 Disable-PSRemoting사용합니다.

예제

예제 1: 기본 구성 사용 안 함

다음은 Microsoft.PowerShell 세션 구성을 사용하지 않도록 설정하는 예제입니다.

Disable-PSSessionConfiguration

예제 2: 등록된 모든 세션 구성 사용 안 함

이 예제에서는 컴퓨터에서 등록된 모든 세션 구성을 사용하지 않도록 설정합니다.

Disable-PSSessionConfiguration -Name *

예제 3: 이름으로 세션 구성 비활성화

다음은 Microsoft로 시작하는 이름이 있는 모든 세션 구성을 사용하지 않도록 설정하는 예제입니다. Force 매개 변수는 cmdlet의 모든 사용자 프롬프트를 억제합니다.

Disable-PSSessionConfiguration -Name Microsoft* -Force

예제 4: 파이프라인을 사용하여 세션 구성 사용 안 함

다음은 MaintenanceShell 및 AdminShell 세션 구성을 사용하지 않도록 설정하는 예제입니다. 파이프라인 연산자(|)는 Get-PSSessionConfiguration 결과를 Disable-PSSessionConfiguration보냅니다.

Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

예제 5: 세션 구성을 사용하지 않도록 설정하는 효과

이 예제에서는 Disable-PSSessionConfiguration 실행 전후의 사용 권한 및 세션 구성을 사용하지 않도록 설정하는 효과를 보여 줍니다.

PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message : Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed

비고

구성을 사용하지 않도록 설정해도 Set-PSSessionConfiguration cmdlet을 사용하여 구성을 변경할 수 없습니다. 구성 사용만을 방지합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

사용하지 않도록 설정할 세션 구성의 이름 배열을 지정합니다. 하나 이상의 구성 이름을 입력합니다. 와일드카드 문자가 허용됩니다. 구성 이름 또는 세션 구성 개체가 포함된 문자열을 파이프하여 Disable-PSSessionConfiguration수도 있습니다.

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

(All)
Position:0
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-NoServiceRestart

WSMan 서비스의 다시 시작을 방지하는 데 사용됩니다. 구성을 사용하지 않도록 설정하기 위해 서비스를 다시 시작할 필요는 없습니다.

매개 변수 속성

형식: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을 실행하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작해야 합니다.