컴퓨터에서 등록된 세션 구성을 삭제합니다.

구문

Unregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Unregister-PSSessionConfiguration cmdlet은 컴퓨터에서 등록된 세션 구성을 삭제합니다. 이 cmdlet은 시스템 관리자가 사용자에 대한 사용자 지정된 세션 구성을 관리하는 데 사용하도록 설계된 고급 cmdlet입니다.

기본 Microsoft.PowerShell 또는 Microsoft.PowerShell32 세션 구성을 실수로 삭제한 경우 Enable-PSRemoting cmdlet을 사용하여 복원할 수 있습니다.

매개 변수

-Force

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

다시 시작하지 않고 다시 시작에 대한 확인 메시지를 표시하지 않으려면 NoServiceRestart 매개 변수를 사용합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Name <string>

삭제할 세션 구성의 이름을 지정합니다. 하나 이상의 구성 이름을 입력합니다. 와일드카드를 사용할 수 있습니다. 이 매개 변수는 필수 사항입니다.

세션 구성 개체를 Unregister-PSSessionConfiguration으로 파이프할 수도 있습니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-NoServiceRestart

WinRM 서비스를 다시 시작하지 않고, 서비스 다시 시작에 대한 확인 메시지를 표시하지 않습니다.

Unregister-PSSessionConfiguration 명령을 입력하면 기본적으로 WinRM 서비스를 다시 시작하여 변경 내용을 적용할지를 묻는 메시지가 표시됩니다. WinRM 서비스를 다시 시작할 때까지 사용자는 Get-PSSessionConfiguration에서 등록되지 않은 세션 구성을 찾지 못하지만 여전히 해당 구성을 사용할 수 있습니다.

확인 메시지를 표시하지 않고 WinRM 서비스를 다시 시작하려면 Force 매개 변수를 사용합니다. WinRM 서비스를 수동으로 다시 시작하려면 Restart-Service cmdlet을 사용합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Confirm

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

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

세션 구성 개체를 Get-PSSessionConfiguration에서 Unregister-PSSessionConfiguration으로 파이프할 수 있습니다.

출력

없음

이 cmdlet은 어떠한 개체도 반환하지 않습니다.

참고

Windows Vista 및 Windows Server 2008 이상 버전에서 이 cmdlet을 실행하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 시작해야 합니다.

예 1

C:\PS>unregister-pssessionconfiguration -name MaintenanceShell

설명
-----------
이 명령은 컴퓨터에서 MaintenanceShell 세션 구성을 삭제합니다.

예 2

C:\PS>unregister-pssessionconfiguration -maintenanceShell -force

설명
-----------
이 명령은 컴퓨터에서 MaintenanceShell 세션 구성을 삭제합니다. 이 명령은 Force 매개 변수를 사용하여 모든 사용자 메시지를 표시하지 않고 확인 메시지 없이 WinRM 서비스를 다시 시작합니다.

예 3

C:\PS>unregister-pssessionconfiguration -name *

C:\PS> get-pssessionconfiguration -name * | unregister-pssessionconfiguration

설명
-----------
이들 명령은 컴퓨터의 모든 세션 구성을 삭제합니다. 명령의 결과는 동일하며 상호 교환적으로 사용할 수 있습니다.

예 4

C:\PS>unregister-pssessionconfiguration -name maintenanceShell -noServiceRestart

C:\PS> get-pssessionconfiguration -name maintenanceShell

Get-PSSessionConfiguration -name maintenanceShell : No Session Configuration matches criteria "maintenanceShell".
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

C:\PS> new-pssession -configurationName MaintenanceShell

 Id Name      ComputerName    State    Configuration         Availability
 -- ----      ------------    -----    -------------         ------------
  1 Session1  localhost       Opened   MaintenanceShell      Available

C:\PS> restart-service winrm

C:\PS> new-pssession -configurationName MaintenanceShell
[localhost] Connecting to remote server failed with the following error message : The WS-Management service cannot process the request. The resource
URI (https://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog. The catalog contains the metadata that describes resour
ces, or logical endpoints. For more information, see the about_Remote_Troubleshooting Help topic.
    + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
    + FullyQualifiedErrorId : PSSessionOpenFailed

설명
-----------
이 예에서는 Unregister-PSSessionConfiguration의 NoServiceRestart 매개 변수를 사용했을 때의 결과를 보여 줍니다. 이 매개 변수는 컴퓨터의 모든 세션에 방해가 되는 서비스 다시 시작을 방지합니다.

첫 번째 명령은 Unregister-PSSessionConfiguration cmdlet을 사용하여 MaintenanceShell 세션 구성을 삭제합니다. 그러나 이 명령은 NoServiceRestart 매개 변수를 사용하므로 WinRM 서비스가 다시 시작되지 않았으며 변경 내용이 아직 적용되지 않았습니다.

두 번째 명령은 Get-PSSessionConfiguration cmdlet을 사용하여 MaintenanceShell 세션을 가져옵니다. WS-Management 리소스 테이블에서 세션이 제거되었으므로 Get-PSSession에서 해당 세션을 반환할 수 없습니다.

세 번째 명령은 New-PSSession cmdlet을 사용하여 로컬 컴퓨터에서 MaintenanceShell 구성을 사용하는 세션을 만듭니다. 명령이 성공합니다.

네 번째 명령은 Restart-Service cmdlet을 사용하여 WinRM 서비스를 다시 시작합니다. 

다섯 번째 명령은 다시 New-PSSession cmdlet을 사용하여 MaintenanceShell 구성을 사용하는 세션을 만듭니다. 이번에는 MaintenanceShell 구성이 삭제되었으므로 세션이 실패합니다.

참고 항목



목차