Add-Computer

Referensi

Modul:: Microsoft.PowerShell.Management

Tambahkan komputer lokal ke domain atau grup kerja.

Sintaks

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>]

Deskripsi

Add-Computer Cmdlet menambahkan komputer lokal atau komputer jarak jauh ke domain atau grup kerja, atau memindahkannya dari satu domain ke domain lain. Ini juga membuat akun domain jika komputer ditambahkan ke domain tanpa akun.

Anda dapat menggunakan parameter cmdlet ini untuk menentukan unit organisasi (OU) dan pengendali domain atau untuk melakukan gabungan yang tidak aman.

Untuk mendapatkan hasil perintah, gunakan parameter Verbose dan PassThru .

Contoh

Contoh 1: Tambahkan komputer lokal ke domain lalu mulai ulang komputer

Add-Computer -DomainName Domain01 -Restart

Perintah ini menambahkan komputer lokal ke domain Domain01 lalu memulai ulang komputer untuk membuat perubahan efektif.

Contoh 2: Menambahkan komputer lokal ke grup kerja

Add-Computer -WorkgroupName WORKGROUP-A

Perintah ini menambahkan komputer lokal ke grup kerja Workgroup-A.

Contoh 3: Menambahkan komputer lokal ke domain

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

Perintah ini menambahkan komputer lokal ke domain Domain01 dengan menggunakan Domain01\DC01 pengendali domain.

Perintah menggunakan parameter PassThru dan Verbose untuk mendapatkan informasi terperinci tentang hasil perintah.

Contoh 4: Menambahkan komputer lokal ke domain menggunakan parameter OUPath

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Perintah ini menambahkan komputer lokal ke domain Domain02. Ini menggunakan parameter OUPath untuk menentukan unit organisasi untuk akun baru.

Contoh 5: Menambahkan komputer lokal ke domain menggunakan kredensial

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

Perintah ini menambahkan komputer Server01 ke domain Domain02. Ini menggunakan parameter LocalCredential untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer Server01. Ini menggunakan parameter Kredensial untuk menentukan akun pengguna yang memiliki izin untuk bergabung dengan komputer ke domain. Ini menggunakan parameter Hidupkan ulang untuk menghidupkan ulang komputer setelah operasi gabungan selesai dan parameter Paksa untuk menekan pesan konfirmasi pengguna.

Contoh 6: Memindahkan sekelompok komputer ke domain baru

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Perintah ini memindahkan komputer Server01 dan Server02, dan komputer lokal, dari Domain01 ke Domain02.

Ini menggunakan parameter LocalCredential untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke tiga komputer yang terpengaruh. Ini menggunakan parameter UnjoinDomainCredential untuk menentukan akun pengguna yang memiliki izin untuk membatalkan bergabung dengan komputer dari domain Domain01 dan parameter Kredensial untuk menentukan akun pengguna yang memiliki izin untuk bergabung dengan komputer ke domain Domain02. Ini menggunakan parameter Hidupkan ulang untuk menghidupkan ulang ketiga komputer setelah pemindahan selesai.

Contoh 7: Memindahkan komputer ke domain baru dan mengubah nama komputer

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Perintah ini memindahkan komputer Server01 ke Domain02 dan mengubah nama komputer menjadi Server044.

Perintah menggunakan kredensial pengguna saat ini untuk menyambungkan ke komputer Server01 dan membatalkan bergabung dengannya dari domainnya saat ini. Ini menggunakan parameter Kredensial untuk menentukan akun pengguna yang memiliki izin untuk bergabung dengan komputer ke domain Domain02.

Contoh 8: Menambahkan komputer yang tercantum dalam file ke domain baru

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

Perintah ini menambahkan komputer yang tercantum dalam Servers.txt file ke domain Domain02. Ini menggunakan parameter Opsi untuk menentukan opsi Win9xUpgrade . Parameter Hidupkan ulang semua komputer yang baru ditambahkan setelah operasi gabungan selesai.

Contoh 9: Menambahkan komputer ke domain menggunakan kredensial komputer yang telah ditentukan sebelumnya

Perintah pertama ini harus dijalankan oleh administrator dari komputer yang sudah bergabung ke domain 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

Kombinasi perintah ini membuat akun komputer baru dengan nama yang telah ditentukan sebelumnya dan kata sandi gabungan sementara di domain menggunakan komputer yang bergabung dengan domain yang sudah ada. Kemudian secara terpisah, komputer dengan nama yang telah ditentukan sebelumnya bergabung dengan domain hanya menggunakan nama komputer dan kata sandi gabungan sementara. Kata sandi yang telah ditentukan sebelumnya hanya digunakan untuk mendukung operasi gabungan dan diganti sebagai bagian dari prosedur akun komputer normal setelah komputer menyelesaikan gabungan.

Contoh 10: Menambahkan Komputer ke domain dengan nama baru

Menggunakan kombinasi perintah ini menghindari beberapa boot ulang dan beberapa penulisan ke Direktori Aktif menulis untuk objek yang sama ketika komputer menggabungkan domain dengan nama baru.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

Parameter

-ComputerName

Menentukan komputer yang akan ditambahkan ke domain atau grup kerja. Defaultnya adalah komputer lokal.

Ketik nama NetBIOS, alamat Protokol Internet (IP), atau nama domain yang sepenuhnya memenuhi syarat dari setiap komputer jarak jauh. Untuk menentukan komputer lokal, ketik nama komputer, titik (.), atau "localhost".

Parameter ini tidak bergantung pada jarak jauh Windows PowerShell. Anda dapat menggunakan Add-Computer meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	String[]
Position:	Named
Nilai default:	Local computer
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

Menentukan akun pengguna yang memiliki izin untuk bergabung dengan komputer ke domain baru. Defaultnya adalah pengguna saat ini.

Ketik nama pengguna, seperti "User01" atau "Domain01\User01", atau masukkan objek PSCredential , seperti yang dihasilkan oleh Get-Credential cmdlet. Jika Anda mengetik nama pengguna, Anda akan dimintai kata sandi.

Untuk menentukan akun pengguna yang memiliki izin untuk menghapus komputer dari domainnya saat ini, gunakan parameter UnjoinDomainCredential . Untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer jarak jauh, gunakan parameter LocalCredential .

Jenis:	PSCredential
Alias:	DomainCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DomainName

Menentukan domain tempat komputer ditambahkan. Parameter ini diperlukan saat menambahkan komputer ke domain.

Jenis:	String
Alias:	DN, Domain
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Force

Menekan prompt konfirmasi pengguna. Tanpa parameter ini, Add-Computer mengharuskan Anda untuk mengonfirmasi penambahan setiap komputer.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-LocalCredential

Menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer yang ditentukan oleh parameter ComputerName . Defaultnya adalah pengguna saat ini.

Untuk menentukan akun pengguna yang memiliki izin untuk menambahkan komputer ke domain baru, gunakan parameter Kredensial . Untuk menentukan akun pengguna yang memiliki izin untuk menghapus komputer dari domain mereka saat ini, gunakan parameter UnjoinDomainCredential .

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	PSCredential
Position:	Named
Nilai default:	Current user
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-NewName

Menentukan nama baru untuk komputer di domain baru. Parameter ini valid hanya ketika satu komputer sedang ditambahkan atau dipindahkan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Options

Menentukan opsi tingkat lanjut untuk Add-Computer operasi gabungan. Masukkan satu atau beberapa nilai dalam string yang dipisahkan koma.

Nilai yang dapat diterima untuk parameter ini adalah:

AccountCreate: Membuat akun domain. Add-Computer Cmdlet secara otomatis membuat akun domain saat menambahkan komputer ke domain. Opsi ini disertakan untuk kelengkapan.
Win9XUpgrade: Menunjukkan bahwa operasi gabungan adalah bagian dari peningkatan sistem operasi Windows.
UnsecuredJoin: Melakukan gabungan yang tidak aman. Untuk meminta gabungan yang tidak aman, gunakan parameter Tidak Aman atau opsi ini. Jika Anda ingin meneruskan kata sandi komputer, maka Anda harus menggunakan opsi ini dalam kombinasi dengan PasswordPass opsi.
PasswordPass: Mengatur kata sandi komputer ke nilai parameter Credential(DomainCredential) setelah melakukan gabungan yang tidak aman. Opsi ini juga menunjukkan bahwa nilai parameter Kredensial (DomainCredential) adalah kata sandi komputer, bukan kata sandi pengguna. Opsi ini hanya valid ketika UnsecuredJoin opsi ditentukan. Saat menggunakan opsi ini, kredensial yang disediakan untuk -Credential parameter harus memiliki nama pengguna null.
JoinWithNewName: Mengganti nama komputer di domain baru menjadi nama yang ditentukan oleh parameter NewName . Saat Anda menggunakan parameter NewName , opsi ini diatur secara otomatis. Opsi ini dirancang untuk digunakan dengan cmdlet Ganti Nama-Komputer. Jika Anda menggunakan Rename-Computer cmdlet untuk mengganti nama komputer, tetapi jangan mulai ulang komputer untuk membuat perubahan efektif, Anda dapat menggunakan parameter ini untuk menggabungkan komputer ke domain dengan nama barunya.
JoinReadOnly: Menggunakan akun komputer yang ada untuk bergabung dengan komputer ke pengontrol domain baca-saja. Akun komputer harus ditambahkan ke daftar yang diizinkan untuk kebijakan replikasi kata sandi dan kata sandi akun harus direplikasi ke pengendali domain baca-saja sebelum operasi gabungan.
InstallInvoke: Mengatur bendera buat (0x2) dan hapus (0x4) parameter FJoinOptions dari metode JoinDomainOrWorkgroup . Untuk informasi selengkapnya tentang metode JoinDomainOrWorkgroup , lihat Metode JoinDomainOrWorkgroup dari kelas Win32_ComputerSystem. Untuk informasi selengkapnya tentang opsi ini, lihat Fungsi NetJoinDomain.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	JoinOptions
Nilai yang diterima:	AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-OUPath

Menentukan unit organisasi (OU) untuk akun domain. Masukkan nama lengkap OU khusus dalam tanda kutip. Nilai default adalah unit organisasi default untuk objek komputer di domain.

Jenis:	String
Alias:	OU
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PassThru

Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Restart

Memulai ulang komputer yang ditambahkan ke domain atau grup kerja. Mulai ulang sering diperlukan untuk membuat perubahan efektif.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Server

Menentukan nama pengendali domain yang menambahkan komputer ke domain. Masukkan nama dalam format DomainName\ComputerName. Secara default, tidak ada pengendali domain yang ditentukan.

Jenis:	String
Alias:	DC
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-UnjoinDomainCredential

Menentukan akun pengguna yang memiliki izin untuk menghapus komputer dari domain mereka saat ini. Defaultnya adalah pengguna saat ini.

Gunakan parameter ini saat Anda memindahkan komputer ke domain lain. Untuk menentukan akun pengguna yang memiliki izin untuk bergabung dengan domain baru, gunakan parameter Kredensial . Untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer jarak jauh, gunakan parameter LocalCredential .

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Unsecure

Melakukan gabungan yang tidak aman ke domain yang ditentukan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WorkgroupName

Menentukan nama grup kerja tempat komputer ditambahkan. Nilai defaultnya adalah "WORKGROUP".

Jenis:	String
Alias:	WGN
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

Anda dapat menyalurkan nama komputer dan nama baru ke Add-Computer Cmdlet.

Output

ComputerChangeInfo

Saat Anda menggunakan parameter PassThru , Add-Computer mengembalikan objek ComputerChangeInfo . Jika tidak, cmdlet ini tidak menghasilkan output apa pun.

Catatan

Di Windows PowerShell 2.0, Add-Computer gagal bahkan ketika server ada. Di Windows PowerShell 3.0, implementasi parameter Server diubah sehingga berfungsi dengan andal.

Bagikan melalui

Add-Computer

Sintaks

Deskripsi

Contoh

Contoh 1: Tambahkan komputer lokal ke domain lalu mulai ulang komputer

Contoh 2: Menambahkan komputer lokal ke grup kerja

Contoh 3: Menambahkan komputer lokal ke domain

Contoh 4: Menambahkan komputer lokal ke domain menggunakan parameter OUPath

Contoh 5: Menambahkan komputer lokal ke domain menggunakan kredensial

Contoh 6: Memindahkan sekelompok komputer ke domain baru

Contoh 7: Memindahkan komputer ke domain baru dan mengubah nama komputer

Contoh 8: Menambahkan komputer yang tercantum dalam file ke domain baru

Contoh 9: Menambahkan komputer ke domain menggunakan kredensial komputer yang telah ditentukan sebelumnya

Contoh 10: Menambahkan Komputer ke domain dengan nama baru

Parameter

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Input

Output

Catatan

Link Terkait