Add-Computer

Modul:

Microsoft.PowerShell.Management Module

Tambahkan komputer lokal ke domain atau grup kerja.

Sintaks

Domain (Default)

Add-Computer
    [-DomainName] <String>
    -Credential <PSCredential>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-UnjoinDomainCredential <PSCredential>]
    [-OUPath <String>]
    [-Server <String>]
    [-Unsecure]
    [-Options <JoinOptions>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Workgroup

Add-Computer
    [-WorkgroupName] <String>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

cmdlet Add-Computer menambahkan komputer lokal atau komputer jarak jauh ke domain atau grup kerja, atau memindahkannya dari satu domain ke domain lainnya. 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 Restart untuk menghidupkan ulang komputer setelah operasi gabungan selesai dan parameter Force 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 Restart 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 parameter ComputerNameAdd-Computer meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	String[]
Nilai default:	Local computer
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 cmdlet Get-Credential. 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.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	DomainCredential

Kumpulan parameter

Domain

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

Workgroup

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DomainName

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	DN, Ruang Lingkup

Kumpulan parameter

Domain

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 cmdlet Get-Credential. 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.

Properti parameter

Jenis:	PSCredential
Nilai default:	Current user
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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:

• AccountBuat: Membuat akun domain. cmdlet Add-Computer 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 parameterKredensial (DomainCredential) setelah melakukan gabungan yang tidak aman. Opsi ini juga menunjukkan bahwa nilai parameter Kredensial (DomainCredential) adalah kata sandi mesin, 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 Rename-Computer. Jika Anda menggunakan cmdlet Rename-Computer untuk mengganti nama komputer, tetapi jangan mulai ulang komputer agar 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) dari parameter FJoinOptions 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.

Properti parameter

Jenis:	JoinOptions
Nilai default:	None
Nilai yang diterima:	AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Domain

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	OU

Kumpulan parameter

Domain

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PassThru

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Server

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

Mulai Agustus 2024, penguatan keamanan untuk gabungan domain mengharuskan Anda menggunakan FQDN pengendali domain. Misalnya: DC1.contoso.com. Untuk informasi selengkapnya, lihat NetJoin Domain Join Hardening Changes.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	DC

Kumpulan parameter

Domain

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 cmdlet Get-Credential. 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.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Domain

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Unsecure

Melakukan gabungan yang tidak aman ke domain yang ditentukan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Domain

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WorkgroupName

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	WGN

Kumpulan parameter

Workgroup

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

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

Output

ComputerChangeInfo

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

Catatan

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

Link Terkait

• Checkpoint-Computer
• Hapus Komputer
• Mulai Ulang Komputer
• Ganti Nama Komputer
• Pulihkan-Komputer
• Matikan-Komputer
• Uji-Koneksi