Add-Computer
로컬 컴퓨터를 도메인 또는 작업 그룹에 추가합니다.
구문
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
-Credential <PSCredential>
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
cmdlet은 Add-Computer 로컬 컴퓨터 또는 원격 컴퓨터를 도메인 또는 작업 그룹에 추가하거나 한 도메인에서 다른 도메인으로 이동합니다. 컴퓨터가 계정 없이 도메인에 추가된 경우 도메인 계정도 생성됩니다.
이 cmdlet의 매개 변수를 사용하여 OU(조직 구성 단위) 및 도메인 컨트롤러를 지정하거나 보안되지 않은 가입을 수행할 수 있습니다.
명령의 결과를 가져오려면 자세한 정보 표시 및 PassThru 매개 변수를 사용합니다.
예제
예제 1: 도메인에 로컬 컴퓨터를 추가한 다음 컴퓨터를 다시 시작합니다.
Add-Computer -DomainName Domain01 -Restart이 명령은 도메인01 도메인에 로컬 컴퓨터를 추가한 다음 컴퓨터를 다시 시작하여 변경 사항을 적용합니다.
예제 2: 작업 그룹에 로컬 컴퓨터 추가
Add-Computer -WorkgroupName WORKGROUP-A이 명령은 로컬 컴퓨터를 Workgroup-A 작업 그룹에 추가합니다.
예제 3: 도메인에 로컬 컴퓨터 추가
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose이 명령은 도메인 컨트롤러를 사용하여 Domain01\DC01 도메인01 도메인에 로컬 컴퓨터를 추가합니다.
이 명령은 PassThru 및 자세한 정보 표시 매개 변수를 사용하여 명령의 결과에 대한 자세한 정보를 가져옵니다.
예제 4: OUPath 매개 변수를 사용하여 도메인에 로컬 컴퓨터 추가
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"이 명령은 Domain02 도메인에 로컬 컴퓨터를 추가합니다. OUPath 매개 변수를 사용하여 새 계정에 대한 조직 구성 단위를 지정합니다.
예제 5: 자격 증명을 사용하여 도메인에 로컬 컴퓨터 추가
$addComputerSplat = @{
ComputerName = 'Server01'
LocalCredential = 'Server01\Admin01'
DomainName = 'Domain02'
Credential = 'Domain02\Admin02'
Restart = $true
Force = $true
}
Add-Computer @addComputerSplat이 명령은 Server01 컴퓨터를 Domain02 도메인에 추가합니다. LocalCredential 매개 변수를 사용하여 Server01 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정합니다. 자격 증명 매개 변수를 사용하여 컴퓨터를 도메인에 조인할 수 있는 권한이 있는 사용자 계정을 지정합니다. 다시 시작 매개 변수를 사용하여 조인 작업이 완료된 후 컴퓨터를 다시 시작하고 Force 매개 변수를 사용하여 사용자 확인 메시지를 표시하지 않습니다.
예제 6: 컴퓨터 그룹을 새 도메인으로 이동
$addComputerSplat = @{
ComputerName = 'Server01', 'Server02', 'localhost'
DomainName = 'Domain02'
LocalCredential = 'Domain01\User01'
UnjoinDomainCredential = 'Domain01\Admin01'
Credential = 'Domain02\Admin01'
Restart = $true
}
Add-Computer @addComputerSplat이 명령은 Server01 및 Server02 컴퓨터와 로컬 컴퓨터를 Domain01에서 Domain02로 이동합니다.
LocalCredential 매개 변수를 사용하여 영향을 받는 세 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정합니다. UnjoinDomainCredential 매개 변수를 사용하여 Domain01 도메인에서 컴퓨터를 조인 해제할 수 있는 권한이 있는 사용자 계정을 지정하고, 자격 증명 매개 변수는 컴퓨터를 Domain02 도메인에 가입할 수 있는 권한이 있는 사용자 계정을 지정합니다. 다시 시작 매개 변수를 사용하여 이동이 완료된 후 세 대의 컴퓨터를 모두 다시 시작합니다.
예제 7: 컴퓨터를 새 도메인으로 이동하고 컴퓨터의 이름을 변경합니다.
$addComputerSplat = @{
ComputerName = 'Server01'
DomainName = 'Domain02'
NewName = 'Server044'
Credential = 'Domain02\Admin01'
Restart = $true
}
Add-Computer @addComputerSplat이 명령은 Server01 컴퓨터를 Domain02로 이동하고 컴퓨터 이름을 Server044로 변경합니다.
이 명령은 현재 사용자의 자격 증명을 사용하여 Server01 컴퓨터에 연결하고 현재 도메인에서 가입을 해제합니다. 자격 증명 매개 변수를 사용하여 컴퓨터를 Domain02 도메인에 가입할 수 있는 권한이 있는 사용자 계정을 지정합니다.
예제 8: 파일에 나열된 컴퓨터를 새 도메인에 추가
$addComputerSplat = @{
ComputerName = (Get-Content Servers.txt)
DomainName = 'Domain02'
Credential = 'Domain02\Admin02'
Options = 'Win9xUpgrade'
Restart = $true
}
Add-Computer @addComputerSplat이 명령은 파일에 나열된 Servers.txt 컴퓨터를 Domain02 도메인에 추가합니다. Options 매개 변수를 사용하여 Win9xUpgrade 옵션을 지정합니다. 다시 시작 매개 변수는 조인 작업이 완료된 후 새로 추가된 모든 컴퓨터를 다시 시작합니다.
예제 9: 미리 정의된 컴퓨터 자격 증명을 사용하여 도메인에 컴퓨터 추가
이 첫 번째 명령은 도메인에 이미 가입된 Domain03컴퓨터에서 관리자가 실행해야 합니다.
$newADComputerSplat = @{
Name = "Server02"
AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat
# Then this command is run from `Server02` which is not yet domain-joined:
$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
UserName = $null
Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
$addComputerSplat = @{
DomainName = "Domain03"
Options = 'UnsecuredJoin', 'PasswordPass'
Credential = $joinCred
}
Add-Computer @addComputerSplat이 명령 조합은 기존 도메인에 가입된 컴퓨터를 사용하여 도메인에 미리 정의된 이름과 임시 조인 암호를 사용하여 새 컴퓨터 계정을 만듭니다. 그런 다음, 미리 정의된 이름을 가진 컴퓨터는 컴퓨터 이름과 임시 조인 암호만 사용하여 도메인에 조인합니다. 미리 정의된 암호는 조인 작업을 지원하는 데만 사용되며 컴퓨터가 조인을 완료한 후 일반 컴퓨터 계정 절차의 일부로 대체됩니다.
예제 10: 새 이름을 가진 도메인에 컴퓨터 추가
이 명령 조합을 사용하면 컴퓨터가 도메인을 새 이름으로 조인할 때 동일한 개체에 대해 여러 번 다시 부팅되고 Active Directory에 쓰기가 여러 번 기록되지 않습니다.
Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
DomainName = 'Contoso.com'
Credential = 'contoso\administrator'
Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat매개 변수
-ComputerName
도메인 또는 작업 그룹에 추가할 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.
NetBIOS 이름, IP(인터넷 프로토콜) 주소 또는 각 원격 컴퓨터의 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, 점(.) 또는 "localhost"를 입력합니다.
이 매개 변수는 Windows PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 ComputerName 매개 변수 Add-Computer 를 사용할 수 있습니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | Local computer |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
컴퓨터를 새 도메인에 가입할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.
현재 도메인에서 컴퓨터를 제거할 수 있는 권한이 있는 사용자 계정을 지정하려면 UnjoinDomainCredential 매개 변수를 사용합니다. 원격 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정하려면 LocalCredential 매개 변수를 사용합니다.
| 형식: | PSCredential |
| 별칭: | DomainCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DomainName
컴퓨터가 추가되는 도메인을 지정합니다. 이 매개 변수는 도메인에 컴퓨터를 추가할 때 필요합니다.
| 형식: | String |
| 별칭: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Force
사용자 확인 프롬프트를 표시하지 않습니다. 이 매개 변수 Add-Computer 가 없으면 각 컴퓨터의 추가를 확인해야 합니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LocalCredential
ComputerName 매개 변수로 지정된 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.
컴퓨터를 새 도메인에 추가할 수 있는 권한이 있는 사용자 계정을 지정하려면 자격 증명 매개 변수를 사용합니다. 현재 도메인에서 컴퓨터를 제거할 수 있는 권한이 있는 사용자 계정을 지정하려면 UnjoinDomainCredential 매개 변수를 사용합니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NewName
새 도메인에 있는 컴퓨터의 새 이름을 지정합니다. 이 매개 변수는 한 컴퓨터를 추가하거나 이동하는 경우에만 유효합니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Options
조인 작업에 대한 Add-Computer 고급 옵션을 지정합니다. 쉼표로 구분된 문자열로 값을 하나 이상 입력하세요.
이 매개 변수에 허용되는 값은 다음과 같습니다.
AccountCreate: 도메인 계정을 만듭니다. cmdlet은
Add-Computer도메인에 컴퓨터를 추가할 때 도메인 계정을 자동으로 만듭니다. 이 옵션은 완전성을 위해 포함됩니다.Win9XUpgrade: 조인 작업이 Windows 운영 체제 업그레이드의 일부임을 나타냅니다.
UnsecuredJoin: 보안되지 않은 조인을 수행합니다. 보안되지 않은 조인을 요청하려면 보안되지 않은 매개 변수 또는 이 옵션을 사용합니다. 컴퓨터 암호를 전달하려면 이 옵션을 옵션과 함께
PasswordPass사용해야 합니다.PasswordPass: 보안되지 않은 조인을 수행한 후 컴퓨터 암호를 Credential(DomainCredential) 매개 변수 값으로 설정합니다. 또한 이 옵션은 Credential(DomainCredential) 매개 변수의 값이 사용자 암호가 아닌 컴퓨터 암호임을 나타냅니다. 이 옵션은 옵션이 지정된 경우에만
UnsecuredJoin유효합니다. 이 옵션을 사용하는 경우 매개 변수에 제공된 자격 증명에는-Credentialnull 사용자 이름이 있어야 합니다.JoinWithNewName: 새 도메인의 컴퓨터 이름을 NewName 매개 변수로 지정된 이름으로 바꿉니다. NewName 매개 변수를 사용하면 이 옵션이 자동으로 설정됩니다. 이 옵션은 Rename-Computer cmdlet과 함께 사용하도록 설계되었습니다. cmdlet을
Rename-Computer사용하여 컴퓨터 이름을 바꾸지만 변경 내용을 적용하기 위해 컴퓨터를 다시 시작하지 않는 경우 이 매개 변수를 사용하여 컴퓨터를 새 이름으로 도메인에 조인할 수 있습니다.JoinReadOnly: 기존 컴퓨터 계정을 사용하여 컴퓨터를 읽기 전용 도메인 컨트롤러에 조인합니다. 컴퓨터 계정을 암호 복제 정책에 대해 허용된 목록에 추가해야 하며, 계정 암호는 조인 작업 전에 읽기 전용 도메인 컨트롤러에 복제되어야 합니다.
InstallInvoke: JoinDomainOrWorkgroup 메서드의 FJoinOptions 매개 변수의 만들기(0x2) 및 삭제(0x4) 플래그를 설정합니다. JoinDomainOrWorkgroup 메서드에 대한 자세한 내용은 Win32_ComputerSystem 클래스의 JoinDomainOrWorkgroup 메서드를 참조하세요. 이러한 옵션에 대한 자세한 내용은 NetJoinDomain 함수를 참조하세요.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | JoinOptions |
| 허용되는 값: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OUPath
도메인 계정에 대한 OU(조직 구성 단위)를 지정합니다. OU의 전체 고유 이름을 따옴표로 입력합니다. 기본값은 도메인의 컴퓨터 개체에 대한 기본 OU입니다.
| 형식: | String |
| 별칭: | OU |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Restart
도메인 또는 작업 그룹에 추가된 컴퓨터를 다시 시작합니다. 변경을 적용하려면 다시 시작해야 하는 경우가 많습니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Server
도메인에 컴퓨터를 추가하는 도메인 컨트롤러의 이름을 지정합니다. 도메인이름\컴퓨터이름 형식으로 이름을 입력합니다. 기본적으로 도메인 컨트롤러는 지정되지 않습니다.
| 형식: | String |
| 별칭: | DC |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UnjoinDomainCredential
현재 도메인에서 컴퓨터를 제거할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.
다른 도메인으로 컴퓨터를 이동하는 경우 이 매개 변수를 사용합니다. 새 도메인에 가입할 수 있는 권한이 있는 사용자 계정을 지정하려면 자격 증명 매개 변수를 사용합니다. 원격 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정하려면 LocalCredential 매개 변수를 사용합니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Unsecure
지정된 도메인에 대한 안전하지 않은 조인을 수행합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WorkgroupName
컴퓨터가 추가되는 작업 그룹의 이름을 지정합니다. 기본값은 "WORKGROUP"입니다.
| 형식: | String |
| 별칭: | WGN |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
컴퓨터 이름과 새 이름을 Cmdlet에 Add-Computer 파이프할 수 있습니다.
출력
PassThru 매개 변수 Add-Computer 를 사용하는 경우 ComputerChangeInfo 개체를 반환합니다.
그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.
참고
- Windows PowerShell 2.0에서는 서버가 있는 경우에도 서버 매개 변수
Add-Computer가 실패합니다. Windows PowerShell 3.0에서는 서버 매개 변수의 구현이 안정적으로 작동하도록 변경됩니다.
관련 링크
PowerShell