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