컴퓨터가 원격 Windows PowerShell 명령을 받지 못하게 합니다.
구문
Disable-PSRemoting [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Disable-PSRemoting 함수는 로컬 컴퓨터에 있는 모든 세션 구성의 보안 설명자에 "모두 거부" 항목을 추가하여 세션 구성을 사용하지 않도록 설정합니다. 이렇게 하면 로컬 컴퓨터가 원격 명령을 수신하지 않습니다.
Disable-PSRemoting은 WinRM 서비스를 중지하지 않으며 로컬 컴퓨터의 사용자가 원격 컴퓨터에 연결하는 세션을 설정하거나 명령을 다른 컴퓨터로 보내지 않도록 합니다.
세션 구성을 다시 설정하려면 Enable-PSRemoting 또는 Enable-PSSessionConfiguration cmdlet을 사용합니다.
Windows Vista 및 Windows Server 2008 이상 버전에서 이 함수를 실행하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 열어야 합니다.
매개 변수
-Force
모든 사용자 확인 메시지를 표시하지 않습니다. 기본적으로 각 작업에 대한 확인 메시지가 표시됩니다.
필수 여부 |
false |
위치 |
named |
기본값 |
False |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
없음 입력을 이 cmdlet으로 파이프할 수 없습니다. |
출력 |
없음 이 cmdlet은 어떠한 개체도 반환하지 않습니다. |
참고
세션 구성은 세션의 환경을 정의하는 설정 그룹입니다. 세션 구성은 원격 컴퓨터에 있으며 컴퓨터에 연결하는 로컬 세션과 원격 세션에서 사용됩니다.
컴퓨터에 연결하는 모든 세션은 컴퓨터에 등록된 세션 구성 중 하나를 사용해야 합니다. 이러한 세션에는 New-PSSession 또는 Enter-PSSession cmdlet을 사용하여 만드는 영구 세션과 WS-Management 원격 기술을 사용하는 Invoke-Command와 같은 cmdlet의 ComputerName 매개 변수를 사용하는 경우 Windows PowerShell에서 만드는 임시 세션이 포함됩니다. 모든 세션 구성에 대한 액세스를 거부하면 모든 사용자가 컴퓨터에 연결하는 세션을 설정할 수 없습니다.
Disable-PSRemoting은 "Disable-PSSessionConfiguration -name *과 동일합니다.
예 1
C:\PS>disable-psremoting 설명 ----------- 이 명령은 컴퓨터의 모든 세션 구성을 사용하지 않도록 설정합니다.
예 2
C:\PS>disable-psremoting -force 설명 ----------- 이 명령은 확인 메시지를 표시하지 않고 컴퓨터의 모든 세션 구성을 사용하지 않도록 설정합니다.
예 3
C:\PS>disable-psremoting -force C:\PS> new-pssession -computername localhost [localhost] Connecting to remote server failed with the following error message : Access is denied. For more information, see the about_Remote_Troub leshooting Help topic. + CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException + FullyQualifiedErrorId : PSSessionOpenFailed C:\PS> new-pssession -computername Server01 Id Name ComputerName State Configuration Availability -- ---- ------------ ----- ------------- ------------ 1 Session1 Server01... Opened Microsoft.PowerShell Available C:\PS> enable-pssessionConfiguration -name * -force C:\PS> new-pssession -computername localhost Id Name ComputerName State Configuration Availability -- ---- ------------ ----- ------------- ------------ 1 Session1 localhost Opened Microsoft.PowerShell Available 설명 ----------- 이 예에서는 Disable-PSRemoting을 사용했을 때의 결과를 보여 줍니다. 첫 번째 명령은 Disable-PSRemoting을 사용하여 로컬 컴퓨터에 등록된 모든 세션 구성을 사용하지 않도록 설정합니다. 두 번째 명령은 New-PSSession을 사용하여 로컬 컴퓨터에 대한 원격 세션을 만듭니다("루프백"이라고도 함). 세션에 필요한 세션 구성이 사용되지 않으므로 명령이 실패합니다. 세 번째 명령은 New-PSSession cmdlet을 사용하여 로컬 컴퓨터에서 Server01 원격 컴퓨터로의 세션을 만듭니다. 이 명령은 원격 컴퓨터의 세션 구성을 사용하므로 성공합니다. 네 번째 명령은 Enable-PSSessionConfiguration cmdlet을 사용하여 로컬 컴퓨터의 모든 세션 구성을 다시 사용하도록 설정합니다. 이 명령은 Name 매개 변수에 *(모두) 값을 사용합니다. 다섯 번째 명령은 New-PSSession cmdlet을 사용하여 다시 루프백 세션을 설정하려고 합니다. 이번에는 필요한 세션 구성을 사용할 수 있으므로 명령이 성공합니다.
예 4
C:\PS>disable-psremoting -force C:\PS> get-psSessionConfiguration | format-table -property name, permission -auto Name Permission ---- ---------- microsoft.powershell Everyone AccessDenied, BUILTIN\Administrators AccessAllowed microsoft.powershell32 Everyone AccessDenied, BUILTIN\Administrators AccessAllowed C:\PS> enable-psremoting -force WinRM already is set up to receive requests on this machine. WinRM already is set up for remote management on this machine. C:\PS>> Get-PSSessionConfiguration | ft name, Permission -auto Name Permission ---- ---------- microsoft.powershell BUILTIN\Administrators AccessAllowed microsoft.powershell32 BUILTIN\Administrators AccessAllowed 설명 ----------- 이 예에서는 Disable-PSRemoting 및 Enable-PSRemoting을 사용했을 때 세션 구성에 미치는 영향을 보여 줍니다. 첫 번째 명령은 Disable-PSRemoting 함수를 사용하여 등록된 모든 세션 구성을 사용하지 않도록 설정합니다. force 매개 변수는 모든 사용자 확인 메시지를 표시하지 않습니다. 두 번째 명령은 Get-PSSessionConfiguration cmdlet을 사용하여 컴퓨터에 등록된 세션 구성을 표시합니다. 이 명령이 파이프라인 연산자를 사용하여 결과를 Format-Table 명령으로 보내면 Format-Table 명령이 구성의 Name 및 Permission 속성만 테이블에 표시합니다. 결과 테이블에는 모든 사용자의 구성 사용 권한이 거부되었다고 표시됩니다. 세 번째 명령은 Enable-PSRemoting cmdlet을 사용하여 컴퓨터의 모든 세션 구성을 다시 사용하도록 설정합니다. "Enable-PsSessionConfiguration -name *" 명령을 사용할 수도 있습니다. 이 명령은 Force 매개 변수를 사용하여 모든 사용자 확인 메시지를 표시하지 않고 확인 메시지 없이 WinRM 서비스를 다시 시작합니다. 네 번째 명령은 Get-PSSessionConfiguration 및 Format-Table을 사용하여 세션 구성의 이름과 사용 권한을 표시합니다. 결과에는 이제 Administrators 그룹의 멤버가 세션 구성에 액세스할 수 있다고 표시됩니다.
참고 항목