다음을 통해 공유


Add-Computer

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

구문

Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Add-Computer cmdlet은 로컬 컴퓨터를 도메인 또는 작업 그룹에 추가하거나 도메인 간에 이동하며, 계정 없이 도메인에 추가된 컴퓨터의 경우 도메인 계정도 만듭니다.

이 cmdlet의 매개 변수를 사용하여 OU(조직 구성 단위) 및 도메인 컨트롤러를 지정하거나 보안되지 않은 가입을 수행할 수 있습니다.

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

매개 변수

-Credential <PSCredential>

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

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

필수 여부

false

위치

named

기본값

현재 사용자의 계정 자격 증명

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-DomainName <string>

컴퓨터 계정의 도메인을 지정합니다. 이 매개 변수는 필수 사항입니다.

필수 여부

true

위치

2

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-OUPath <string>

도메인 계정의 OU(조직 구성 단위)를 지정합니다. OU의 전체 고유 이름을 입력합니다. 기본값은 도메인의 컴퓨터 개체에 대한 기본 OU입니다.

필수 여부

false

위치

named

기본값

도메인의 컴퓨터 개체에 대한 기본 OU

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PassThru

명령 결과를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Server <string>

도메인에 컴퓨터를 추가하는 도메인 컨트롤러의 이름을 지정합니다. 도메인 이름\컴퓨터 이름 형식으로 이름을 입력합니다. 기본값은 로컬 컴퓨터입니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Unsecure

보안되지 않은 가입을 수행합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WorkGroupName <string>

컴퓨터의 작업 그룹 이름을 지정합니다. 이 매개 변수를 생략하면 컴퓨터가 도메인에 가입됩니다.

필수 여부

true

위치

3

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Confirm

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

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

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

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

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

입력 및 출력

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

입력

없음

Add-Computer로 개체를 파이프할 수 없습니다.

출력

Microsoft.PowerShell.Commands.ComputerChangeInfo

PassThru 매개 변수를 사용하는 경우 Add-Computer는 ComputerChangeInfo 개체를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

예 1

C:\PS>add-computer -domainname Domain01; restart-computer

설명
-----------
이들 명령은 현재 사용자의 자격 증명을 사용하여 Domain01 도메인에 로컬 컴퓨터를 추가합니다.

첫 번째 명령은 컴퓨터를 도메인에 추가합니다. 두 번째 명령은 Restart-Computer cmdlet을 사용하여 컴퓨터를 다시 시작합니다. 그러면 가입 작업이 완료됩니다. 세미콜론(;)으로 두 명령을 구분합니다.





예 2

C:\PS>add-computer -workgroupname WORKGROUP-A

설명
-----------
이 명령은 Workgroup-A 작업 그룹에 로컬 컴퓨터를 추가합니다.





예 3

C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose

설명
-----------
이 명령은 Domain01\DC01 도메인 컨트롤러를 사용하여 로컬 컴퓨터를 Domain01 도메인에 추가합니다. 

이 명령은 PassThru 및 Verbose 매개 변수를 사용하여 명령의 결과에 대한 자세한 정보를 표시합니다.





예 4

C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com

설명
-----------
이 명령은 Domain02 도메인에 Server01 및 Server02 컴퓨터를 추가합니다. OUPath 명령을 사용하여 새 계정의 조직 구성 단위를 지정합니다.





예 5

C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru

설명
-----------
이 명령은 도메인 관리자의 자격 증명을 사용하여 Domain02 도메인에 로컬 컴퓨터를 추가하고, PassThru 매개 변수를 사용하여 명령의 결과에 대한 간략한 보고서를 생성합니다.





참고 항목

개념

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