Disable-PSSessionConfiguration

  • 참조
모듈:
Microsoft.PowerShell.Core

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

Syntax

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

Description

cmdlet은 Disable-PSSessionConfiguration 로컬 컴퓨터에서 세션 구성을 사용하지 않도록 설정하므로 모든 사용자가 세션 구성을 사용하여 로컬 컴퓨터에서 사용자 관리 세션(PSSessions)을 만들 수 없습니다. 이 cmdlet은 시스템 관리자가 사용자에 대한 사용자 지정 세션을 관리하는 데 사용할 수 있는 고급 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 및 관리Shell 세션 구성을 사용하지 않도록 설정하는 예제입니다. 파이프라인 연산자(|)는 Get-PSSessionConfigurationDisable-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

참고 항목

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

매개 변수

-Confirm

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

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

-Force

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

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

-Name

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

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

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

-NoServiceRestart

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

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