Add-Computer
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 pengendali domain Domain01\DC01.
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
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force
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
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart
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
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart
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
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
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
:
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
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.
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 parameter Add-Computer
ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Type: | String[] |
Position: | Named |
Default value: | Local computer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | PSCredential |
Aliases: | DomainCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Menentukan domain tempat komputer ditambahkan. Parameter ini diperlukan saat menambahkan komputer ke domain.
Type: | String |
Aliases: | DN, Domain |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
Menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer yang ditentukan oleh parameter ComputerName . 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 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.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
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
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.
Type: | String |
Aliases: | OU |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | DC |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnjoinDomainCredential
Menentukan akun pengguna yang memiliki izin untuk menghapus komputer dari domain mereka saat ini. 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.
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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Unsecure
Melakukan gabungan yang tidak aman ke domain yang ditentukan.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkgroupName
Menentukan nama grup kerja tempat komputer ditambahkan. Nilai defaultnya adalah "WORKGROUP".
Type: | String |
Aliases: | WGN |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Anda dapat menyalurkan nama komputer dan nama baru ke Add-Computer
Cmdlet.
Output
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, parameter
Add-Computer
Server gagal bahkan ketika server ada. Di Windows PowerShell 3.0, implementasi parameter Server diubah sehingga berfungsi dengan andal.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk