Bagikan melalui

Remove-Computer

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menghapus komputer lokal dari domainnya.

Sintaks

Remove-Computer
      [[-UnjoinDomainCredential] <PSCredential>]
      [-Restart]
      [-Force]
      [-PassThru]
      [-WorkgroupName <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Computer
      -UnjoinDomainCredential <PSCredential>
      [-LocalCredential <PSCredential>]
      [-Restart]
      [-ComputerName <String[]>]
      [-Force]
      [-PassThru]
      [-WorkgroupName <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet Remove-Computer menghapus komputer lokal dan komputer jarak jauh dari domain mereka saat ini.

Saat Anda menghapus komputer dari domain, Remove-Computer juga menonaktifkan akun domain komputer. Anda harus memberikan kredensial eksplisit untuk membatalkan bergabung dengan komputer dari domainnya, bahkan ketika mereka adalah kredensial pengguna saat ini. Anda harus memulai ulang komputer agar perubahan efektif. Selain itu, ketika Anda menghapus komputer dari domain, Anda harus memindahkannya ke grup kerja. Gunakan parameter WorkgroupName untuk menentukan grup kerja.

Untuk memindahkan komputer dari grup kerja ke domain, dari satu grup kerja ke grup kerja lainnya, atau dari satu domain ke domain lain, gunakan cmdlet Add-Computer.

Untuk mendapatkan hasil perintah, gunakan parameter Verbose dan PassThru. Untuk menekan permintaan pengguna, gunakan parameter Force.

Remove-Computer menghapus komputer lokal dan komputer jarak jauh dari domain. Ini termasuk parameter kredensial yang menentukan kredensial alternatif untuk menyambungkan ke komputer jarak jauh, dan membatalkan bergabung dari domain, parameter Mulai Ulang untuk memulai ulang komputer yang terpengaruh, dan parameter WorkgroupName untuk menentukan nama grup kerja tempat komputer ditambahkan.

Contoh

Contoh 1: Menghapus komputer lokal dari domainnya

Contoh ini menghapus komputer lokal dari domain tempat komputer digabungkan.

Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart

Parameter UnjoinDomainCredential menyediakan kredensial administrator domain. PassThru dan parameter umum Verbose menampilkan informasi tentang keberhasilan atau kegagalan perintah. Parameter Hidupkan ulang menghidupkan ulang komputer untuk menyelesaikan operasi penghapusan.

Ketika tidak ada nama grup kerja yang ditentukan, komputer dipindahkan ke grup kerja bernama setelah dihapus dari domainnya.

Contoh 2: Memindahkan beberapa komputer ke grup kerja warisan

Contoh ini menghapus semua komputer yang tercantum dalam file OldServers.txt dari domain mereka dan memindahkannya ke grup kerja Warisan.

Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart

Parameter LocalCredential menyediakan kredensial pengguna yang memiliki izin untuk tersambung ke komputer jarak jauh. Parameter UnjoinDomainCredential menyediakan kredensial pengguna yang memiliki izin untuk menghapus komputer dari domain mereka. Parameter Force menekan permintaan konfirmasi untuk setiap komputer. Parameter Hidupkan ulang menghidupkan ulang setiap komputer setelah dihapus dari domainnya.

Contoh 3: Menghapus komputer dari grup kerja tanpa konfirmasi

Contoh ini menghapus komputer jarak jauh, Server01, dan komputer lokal dari domain mereka dan menambahkannya ke grup kerja lokal.

Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force

Parameter Force menekan permintaan konfirmasi untuk setiap komputer. Parameter Hidupkan ulang menghidupkan ulang komputer agar perubahan efektif.

Parameter

-ComputerName

Menentukan komputer yang akan dihapus dari domainnya. Defaultnya adalah komputer lokal.

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

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

Parameter ini diperkenalkan di PowerShell 3.0.

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

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

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

-Force

Menekan permintaan pengguna. Secara default, Remove-Computer meminta konfirmasi sebelum menghapus setiap komputer.

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

-LocalCredential

Menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer yang ditentukan 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, cmdlet akan meminta kata sandi kepada Anda. Untuk menentukan akun pengguna yang memiliki izin untuk menghapus komputer dari domainnya saat ini, gunakan parameter UnjoinDomainCredential.

Parameter ini diperkenalkan di PowerShell 3.0.

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

-PassThru

Mengembalikan hasil perintah. Jika tidak, 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

Menunjukkan bahwa cmdlet ini memulai ulang komputer yang sedang dihapus. Mulai ulang sering diperlukan untuk membuat perubahan efektif.

Parameter ini diperkenalkan di PowerShell 3.0.

Jenis:SwitchParameter
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. Kredensial eksplisit, seperti yang disediakan oleh parameter ini, diperlukan untuk menghapus komputer jarak jauh dari domain, bahkan ketika nilainya adalah kredensial pengguna saat ini.

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

Untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer jarak jauh, gunakan parameter LocalCredential.

Parameter ini diperkenalkan di PowerShell 3.0.

Jenis:PSCredential
Alias:Credential
Position:0
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 ketika dihapus dari domain mereka. Nilai defaultnya adalah WORKGROUP. Saat Anda menghapus komputer dari domain, Anda harus menambahkannya ke grup kerja.

Parameter ini diperkenalkan di PowerShell 3.0.

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

Input

String

Anda dapat menyalurkan nama komputer ke cmdlet ini.

Output

ComputerChangeInfo

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

Catatan

Cmdlet ini tidak menghapus komputer dari grup kerja.