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