Remove-Computer

로컬 컴퓨터를 도메인이나 작업 그룹에서 제거합니다.

구문

Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Remove-Computer cmdlet은 로컬 및 원격 컴퓨터를 현재 작업 그룹이나 도메인에서 제거합니다.

컴퓨터를 도메인에서 제거하는 경우 Remove-Computer는 컴퓨터의 도메인 계정도 사용하지 않도록 설정합니다.

컴퓨터가 도메인의 일부인 경우 현재 사용자의 자격 증명을 사용하고 있는 경우에도 자격 증명을 제공해야 하며 변경 내용을 적용하려면 컴퓨터를 다시 시작해야 합니다.

명령의 결과를 가져오려면 Verbose 및 PassThru 매개 변수를 사용합니다.

매개 변수

-Credential <PSCredential>

이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.

"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에 의해 생성된 것과 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.

도메인에서 컴퓨터를 제거하려면 현재 사용자의 자격 증명을 사용하고 있는 경우에도 Credential 매개 변수를 사용해야 합니다.

필수 여부	false
위치	2
기본값	현재 사용자의 자격 증명
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Force

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-PassThru

명령 결과를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

필수 여부	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에서 반환되는 개체의 유형입니다.

입력	없음 입력을 이 cmdlet으로 파이프할 수 없습니다.
출력	Microsoft.PowerShell.Commands.ComputerChangeInfo PassThru 매개 변수를 사용하는 경우 Remove-Computer는 ComputerChangeInfo 개체를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

예 1

C:\PS>remove-computer

설명
-----------
이 명령은 컴퓨터를 작업 그룹에서 제거합니다.

예 2

C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer

설명
-----------
이들 명령은 로컬 컴퓨터를 가입된 도메인에서 제거합니다.

첫 번째 명령은 컴퓨터를 도메인에서 제거합니다. 이 명령은 Credential 매개 변수를 사용하여 도메인 관리자의 자격 증명을 제공하고 PassThru 매개 변수 및 Verbose 일반 매개 변수를 사용하여 명령의 성공 또는 실패에 대한 정보를 표시합니다.

두 번째 명령은 Restart-Computer cmdlet을 사용하여 컴퓨터를 다시 시작합니다. 제거 작업을 완료하려면 컴퓨터를 다시 시작해야 합니다.

세미콜론(;)으로 두 명령을 구분합니다.

참고 항목

개념

Add-Computer
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection